الصفحة الرئيسية>PHP كود المصدر>فئات أخرى
تنزيل

دومكري

Domquery هي مكتبة PHP تتيح لك اجتياز DOM وتعديلها بسهولة (HTML/XML). كمكتبة تهدف إلى توفير "JQuery Like" الوصول إلى فئة 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) )

* [محدد] يمكن أن يكون محددًا 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 التي تتطابق مع "التالي" التي تسبقها مباشرة من قبل شقيق "سابق"
  • عناصر prev ~ siblings التي تطابق "الأشقاء" التي يسبقها "السابق"
  • * كل المحدد
  • [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) عناصر لا تتطابق مع المحدد فو
  • :has(foo) التي تحتوي على عنصر واحد على الأقل يطابق FOO Selector
  • :contains(foo) التي تحتوي على نص foo
  • :root الذي هو جذر المستند

طرق أخرى (غير jQuery)

  • findOrFail( selector ) العثور على أحفاد كل عنصر في المجموعة الحالية من العناصر المتطابقة ، أو رمي استثناء
  • loadContent(content, encoding='UTF-8') تحميل محتوى html/xml
  • استخدم xpath(xpath_query) xpath للعثور على أحفاد كل عنصر في المجموعة الحالية من العناصر المتطابقة
  • getOuterHtml() احصل على HTML الناتج عن وصف جميع العناصر (مثل (string) $dom ، أو $elm->prop('outerHTML') ))

دعم XML

  • سيتم تحميل محتوى XML تلقائيًا "كـ XML" إذا تم العثور على إعلان XML (سيتم تعيين خاصية xml_mode على TRUE)
  • وهذا بدوره سيجعل الادخار (التقديم) يحدث "كـ XML". يمكنك تعيين خاصية xml_mode إلى FALSE لمنع ذلك.
  • لمنع المحتوى باستخدام تحميل إعلان XML "كـ XML" ، يمكنك تعيين خاصية xml_mode على خطأ ثم استخدام طريقة loadContent($content) .
  • يتم تسجيل مساحات الأسماء تلقائيًا (لا حاجة للقيام بذلك يدويًا)

هربا من شواطئ التعريف في المحدد للعثور على عناصر ذات مساحة الاسم: 

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

عن

متطلبات

  • يعمل مع PHP 7.2 أو أعلى (جرب V0.8 لإصدارات PHP الأقدم)
  • يتطلب امتداد LIBXML PHP (ممكّن افتراضيًا)

إلهام/شكر وتقدير

  • https://github.com/wasinger/htmlpagedom
  • https://github.com/symfony/dom-crawler
  • https://github.com/artack/domquery
  • https://github.com/zendframework/zend-m
  • http://simplehtmldom.sourceforge.net
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل