Download the PHP package manychois/cici without Composer
On this page you can find all versions of the php package manychois/cici. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package cici
Cici
Cici is a PHP library which lets you use CSS selector to locate elements in an HTML document.
Features
- Wide support of CSS3 selector syntax, e.g.
.home dl > dd:nth-child(3n+1 of :has([href$="s.php"])). - Support for namespace checking in element names and attribute names, e.g.
svg|circle. - Complete CSS selector parser written in PHP.
- No dependency on external libraries.
- Write your own DOM library with CSS selector support by implementing
Manychois\Cici\Matching\AbstractMatchContext.
Installation
Usage
The class Manychois\Cici\DomQuery provides three methods to match element(s) by the given CSS selectors:
closest(\DOMElement $element, string $selector, array $nsLookup = []): ?\DOMElement
Traverses the element and its parents (heading toward the document root) until it finds an element that matches the specified CSS selector.query(\DOMNode $scope, string $selector, array $nsLookup = []): ?\DOMElement
Traverses the descendants of the node (in document order) until it finds an element that matches the specified CSS selector.queryAll(\DOMNode $scope, string $selector, array $nsLookup = []): \Generator
Traverses the descendants of the node (in document order) and finds all elements that match the specified CSS selector.
They all accept an optional argument $nsLookup which is an associative array of namespace prefixes and URIs.
This is useful when you need to match elements with specific namespace URI.
If you need to define a default namespace, use the empty string '' as the key.
Examples
Locate an element
Locate an element with a namespace URI
Locate multiple elements
Supported CSS selectors
| Selector | Example | Notes |
|---|---|---|
| Attribute selector | [attr="value" i] |
Namespace prefix is supported. Case-sensitivity modifier is supported. |
| Class selector | .primary |
|
| ID selector | #main |
|
| Type selector | div |
Namespace prefix is supported. |
| Universal selector | * |
Namespace prefix is supported. |
| Pseudo-class selector | :nth-child(2n+1 of .selected) |
Check the section below for supported pseudo-classes. |
| Compound selector | div.active |
|
| Child combinator | ul > li |
|
| Descendant combinator | nav a |
|
| Next-sibling combinator | p + img |
|
| Subsequent-sibling combinator | div ~ img |
|
| Selector list | ul, ol |
Supported pseudo-classes
List in alphabetical order:
:any-link:checked:disabled:empty:enabled:first-child:first-of-type:has:indeterminate:is:last-child:last-of-type:not:nth-child:nth-last-child:nth-last-of-type:nth-of-type:only-child:only-of-type:optional:read-only:read-write:required:root:scope:where
Unsupported CSS selectors
- All pseudo-elements, e.g.
::before. - Column combinator, i.e.
||. - All pseudo-classes which are not listed in the previous section.
Basically anything which involves user interaction, e.g.
:hover, will never be supported.
Performance concern
This library parses the CSS selector string, builds a selector tree, and then traverses the DOM tree in depth-first
search order to locate the element(s).
Since everything is written in PHP, this allows a wider support of CSS selector syntax.
However, this also means that the performance is not comparable to the native PHP functions,
e.g. Document->getElementById(), DOMXPath->query().
In a basic performance test, this library can be 2x to 10x slower than equilvalent DOMXPath->query().
As long as you are fine with the performance of a native PHP foreach loop, this library should be good enough for you.
You can run composer run benchmark to see the performance comparison.
