migrate_plus-8.x-5.x-dev/src/Plugin/migrate/process/DomSelect.php

<?php

declare(strict_types=1);

namespace Drupal\migrate_plus\Plugin\migrate\process;

use Drupal\migrate\MigrateExecutableInterface;
use Drupal\migrate\Row;

/**
 * Select strings from a DOMDocument object.
 *
 * Configuration:
 * - selector: An XPath selector that resolves to a string.
 * - limit: (optional) The maximum number of results to return.
 *
 * Usage:
 *
 * @code
 * process:
 *   bar:
 *     -
 *       plugin: dom
 *       method: import
 *       source: text_field
 *     -
 *       plugin: dom_select
 *       selector: //img/@src
 * @endcode
 *
 * This example will return an array of the src attributes of all <img> tags in
 * the source text. Add 'limit: 1' to return at most one result.
 *
 * @MigrateProcessPlugin(
 *   id = "dom_select"
 * )
 */
class DomSelect extends DomProcessBase {

  /**
   * {@inheritdoc}
   */
  public function transform($value, MigrateExecutableInterface $migrate_executable, Row $row, $destination_property): array {
    $this->init($value, $destination_property);
    $values = [];
    foreach ($this->xpath->query($this->configuration['selector']) as $node) {
      if (isset($this->configuration['limit']) && count($values) >= $this->configuration['limit']) {
        break;
      }
      $values[] = $node->nodeValue;
    }

    return $values;
  }

}