PHPackages                             hop-top/cite - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. hop-top/cite

ActiveLibrary[Utility & Helpers](/categories/utility)

hop-top/cite
============

Custom URI scheme utilities (polyglot).

v0.2.0(1mo ago)01471MITPHPPHP >=8.2

Since May 28Pushed 1mo agoCompare

[ Source](https://github.com/hop-top/cite-php)[ Packagist](https://packagist.org/packages/hop-top/cite)[ Docs](https://hop.top/cite)[ RSS](/packages/hop-top-cite/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (2)Versions (3)Used By (1)

cite (php)
==========

[](#cite-php)

PHP implementation of `cite`, the polyglot custom URI parsing and handler-generation contract for app frameworks, CLIs, and agent-assisted tools.

> This repository is a read-only language mirror. Open issues and pull requests in [`hop-top/poly-cite`](https://github.com/hop-top/poly-cite).

Features
--------

[](#features)

- Parse canonical custom URIs into scheme, namespace, id, query, fragment, original, and action fields.
- Apply configurable namespace policies per scheme.
- Resolve vanity aliases, fuzzy vanity matches, and completion candidates.
- Normalize action queries such as `action=task.claim`, `cmd=task&verb=claim`, and `name=task&action=claim`.
- Resolve action routes to command plans without executing them.
- Register URI types with parsers and completers.
- Generate language-scoped handler artifacts for Linux, macOS/iOS, and Windows.
- Validate behavior against shared polyglot contract fixtures.

Usage
-----

[](#usage)

```
Agent instructions:
Install this PHP library with Composer when published, or use the local php/
package while working inside poly-cite. Import classes from the HopTop\Cite
namespace. For usage docs and contract details, read
https://github.com/hop-top/poly-cite/tree/main/docs and
https://github.com/hop-top/poly-cite/tree/main/spec.

```

### App Authors

[](#app-authors)

Use this package when your app needs stable custom URI identity, vanity links, completion candidates, or handler artifacts.

Basic parsing:

```