DomQuery

Домкри

Domquery - это библиотека PHP, которая позволяет легко пройти и модифицировать DOM (HTML/XML). В качестве библиотеки она направлена ​​на то, чтобы предоставить «jQuery, как», доступ к классу PHP Domdocument (http://php.net/manual/en/book.dom.php).

Установка

Установите последнюю версию с

$ composer require rct567/dom-query

Основное использование

Прочитайте атрибуты и свойства:

 use Rct567  DomQuery  DomQuery ;

$ dom = new DomQuery ( ' <div><h1 class="title">Hello</h1></div> ' );

echo $ dom -> find ( ' h1 ' )-> text (); // output: Hello
echo $ dom -> find ( ' div ' )-> prop ( ' outerHTML ' ); // output: <div><h1 class="title">Hello</h1></div>
echo $ dom -> find ( ' div ' )-> html (); // output: <h1 class="title">Hello</h1>
echo $ dom -> find ( ' div > h1 ' )-> class ; // output: title
echo $ dom -> find ( ' div > h1 ' )-> attr ( ' class ' ); // output: title
echo $ dom -> find ( ' div > h1 ' )-> prop ( ' tagName ' ); // output: h1
echo $ dom -> find ( ' div ' )-> children ( ' h1 ' )-> prop ( ' tagName ' ); // output: h1
echo ( string ) $ dom -> find ( ' div > h1 ' ); // output: <h1 class="title">Hello</h1>
echo count ( $ dom -> find ( ' div, h1 ' )); // output: 2

Траверные узлы (набор результатов):

 use Rct567  DomQuery  DomQuery ;

$ dom = new DomQuery ( ' <a>1</a> <a>2</a> <a>3</a> ' );
$ links = $ dom -> children ( ' a ' );

foreach ( $ links as $ elm ) {
    echo $ elm -> text (); // output 123
}

echo $ links [ 0 ]-> text (); // output 1
echo $ links -> last ()-> text (); // output 3
echo $ links -> first ()-> next ()-> text (); // output 2
echo $ links -> last ()-> prev ()-> text (); // output 2
echo $ links -> get ( 0 )-> textContent ; // output 1
echo $ links -> get (- 1 )-> textContent ; // output 3

Заводский метод (создать альтернативу экземпляра):

 use Rct567  DomQuery  DomQuery ;

DomQuery:: create ( ' <a title="hello"></a> ' )-> attr ( ' title ' ) // hello 

Доступны методы jQuery

Пересечение> обход деревьев

• .find( selector )
• .children( [selector] )
• .parent( [selector] )
• .closest( [selector] )
• .next( [selector] )
• .prev( [selector] )
• .nextAll( [selector] )
• .prevAll( [selector] )
• .nextUntil( [selector] )
• .prevUntil( [selector] )
• .siblings( [selector] )

Пересечение> Разное обход

• .contents() Получите детей, включая текстовые узлы
• .add( selector, [context] ) новый результат с добавленными элементами, которые соответствуют селектору
• .addBack()

Траирование> фильтрация

• .is( selector )
• .filter ( selector ) уменьшите к тем, кто соответствует селектору
• .not( selector ) удалить элементы из набора соответствующих элементов
• .has( selector ) сводится к тем, у кого есть потомки, который соответствует селектору
• .first( [selector] )
• .last( [selector] )
• .slice( [offset] [, length]) как array_slice в php, а не js/jquery
• .eq( index )
• .map( callable(elm,i) )

_{* [selector] может быть селектор CSS или экземпляр Domquery | domnodelist | domnode}

Манипуляция> вставка и удаление DOM

• .text( [text] )
• .html( [html_string] )
• .append( [content],... )
• .prepend( [content],... )
• .after( [content],... )
• .before( [content],... )
• .appendTo( [target] )
• .prependTo( [target] )
• .replaceWith( [content] )
• .wrap( [content] )
• .wrapAll( [content] )
• .wrapInner( [content] )
• .remove( [selector] )

_{* [Контент] может быть HTML или экземпляр Domquery | domnodelist | domnode}

Атрибуты | Манипуляция

• .attr( name [, val] )
• .prop( name [, val] )
• .css( name [, val] )
• .removeAttr( name )
• .addClass( name )
• .hasClass( name )
• .toggleClass ( name )
• .removeClass( [name] )

_{* AddClass, RemoveClass, ToggleClass и RemoveAttr также принимают имена , разделенные массивами или разделенными пространством}

Разное> Методы элементов DOM | Переселение | Хранилище

• .get( index )
• .each ( callable(elm,i) )
• .data ( key [, val] )
• .removeData ( [name] )
• .index ( [selector] )
• .toArray()
• .clone()

Поддерживаемые селекторы

• .class
• #foo
• parent > child
• foo, bar несколько селекторов
• prev + next Elements, соответствующие «Далее», которым сразу предшествовал брат "Prev"
• prev ~ siblings соответствующие «братьям и сестрам», которым предшествует «Prev»
• * Весь селектор
• [name="foo"] значение атрибута равно foo
• [name*="foo"] значение атрибута содержит Foo
• [name~="foo"] значение атрибута содержит слово foo
• [name^="foo"] значение атрибута начинается с Foo
• [name$="foo"] атрибут заканчивается Foo
• [name|="foo"] значение атрибута, равное FOO, или запуск Foo с последующим дефисом (-)

Псевдо селекторы

• :empty
• :even
• :odd
• :first-child
• :last-child
• :only-child
• :nth-child(n)
• :parent элементы, у которых есть хотя бы один ребенок
• :first
• :last
• :header выбирает H1, H2, H3 и т. Д.
• :not(foo) элементы, которые не соответствуют селектору Foo Foo
• :has(foo) элементы, содержащие хотя бы один элемент, который соответствует селектору Foo
• :contains(foo) элементы, которые содержат текст foo
• :root элемент, который является корнем документа

Другие (не jquery) методы

• findOrFail( selector ) Найдите потомков каждого элемента в текущем наборе соответствующих элементов или бросьте исключение
• loadContent(content, encoding='UTF-8') LOAD HTML/XML Content
• xpath(xpath_query) Используйте Xpath, чтобы найти потомков каждого элемента в текущем наборе соответствующих элементов
• getOuterHtml() Get получение HTML, описывающего все элементы (так же, как (string) $dom , или $elm->prop('outerHTML') ))

Поддержка XML

• Содержание XML автоматически загружается «как xml», если обнаружено объявление XML (свойство xml_mode будет установлено на True)
• Это, в свою очередь, также сделает сохранение (рендеринг) произойти «как XML». Вы можете установить свойство xml_mode на false, чтобы предотвратить это.
• Чтобы предотвратить содержание с помощью объявления XML, загружающего «как xml», вы можете установить свойство xml_mode в false, а затем использовать метод loadContent($content) .
• Пространства имен автоматически зарегистрированы (не нужно делать это вручную)

Выбегая мета -карты в селекторе, чтобы найти элементы с пространством имен:

 $ dom -> find ( ' namespace \ :h1 ' )-> text ();

О

Требования

• Работает с PHP 7.2 или выше (попробуйте v0.8 для старых версий PHP)
• Требуется расширение PHP LIBXML (по умолчанию включено)

Вдохновение/подтверждение

• https://github.com/wasinger/htmlpagedom
• https://github.com/symfony/dom-rawler
• https://github.com/artack/domquery
• https://github.com/zendframework/zend-dom
• http://simplehtmldom.sourceforge.net