{"id":34950302,"url":"https://github.com/getnamingo/epp-client","last_synced_at":"2026-02-06T12:31:01.624Z","repository":{"id":65155895,"uuid":"584725016","full_name":"getnamingo/epp-client","owner":"getnamingo","description":"An open-source PHP EPP client supporting 40 domain registry backends. Works with any PHP framework and is fully customizable.","archived":false,"fork":false,"pushed_at":"2026-02-04T10:41:13.000Z","size":896,"stargazers_count":26,"open_issues_count":0,"forks_count":4,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-02-04T23:26:52.720Z","etag":null,"topics":["cctld","epp","epp-client","epp-protocol","epp-registry","forth","gtld","nask","php","registry"],"latest_commit_sha":null,"homepage":"https://namingo.org","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getnamingo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":["https://donate.stripe.com/7sI2aI4jV3Offn28ww","https://www.blockchain.com/btc/address/bc1q9jhxjlnzv0x4wzxfp8xzc6w289ewggtds54uqa","https://etherscan.io/address/0x330c1b148368EE4B8756B176f1766d52132f0Ea8"]}},"created_at":"2023-01-03T11:00:58.000Z","updated_at":"2026-02-04T10:40:30.000Z","dependencies_parsed_at":"2023-12-12T11:30:59.476Z","dependency_job_id":"5689e8fb-32cc-4fc3-8146-c28fd83a9ff8","html_url":"https://github.com/getnamingo/epp-client","commit_stats":{"total_commits":307,"total_committers":1,"mean_commits":307.0,"dds":0.0,"last_synced_commit":"20da0fb84d60fb000caf58f194522115c802d4b4"},"previous_names":["getnamingo/epp-client","getpinga/tembo"],"tags_count":67,"template":false,"template_full_name":null,"purl":"pkg:github/getnamingo/epp-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getnamingo%2Fepp-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getnamingo%2Fepp-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getnamingo%2Fepp-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getnamingo%2Fepp-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getnamingo","download_url":"https://codeload.github.com/getnamingo/epp-client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getnamingo%2Fepp-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29160816,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T07:18:23.844Z","status":"ssl_error","status_checked_at":"2026-02-06T07:13:32.659Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cctld","epp","epp-client","epp-protocol","epp-registry","forth","gtld","nask","php","registry"],"created_at":"2025-12-26T21:24:47.018Z","updated_at":"2026-02-06T12:31:01.614Z","avatar_url":"https://github.com/getnamingo.png","language":"PHP","readme":"# Namingo EPP Client\n\nAn open-source PHP EPP client supporting 41 domain registry backends. Works with any PHP framework and is fully customizable.\n\n[![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md)\n\n[![SWUbanner](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md)\n\n## Introduction  \n\n**Namingo EPP** is an open-source PHP library and tool for working with EPP (Extensible Provisioning Protocol). It provides everything you need to connect to EPP servers, manage domains, and build custom integrations.  \n\n- Works as both a **library** for developers and a **ready-to-use client**  \n- Includes **Loom**, **WHMCS** and **FOSSBilling** registrar modules for easy automation  \n- Supports EPP extensions and can be **extended to new backends** with minimal effort  \n- Simple to integrate into any PHP project  \n\nWith Namingo EPP you can start small, customize as you go, and adapt it to the specific requirements of any domain registry.  \n\n## Features\n\n### Supported EPP Commands\n\n| | domain | contact | host | session |\n|----------|----------|----------|----------|----------|\n| check | ✅ | ✅ | ✅ | login ✅ |\n| checkClaims | ✅ | N/A | N/A | logout ✅ |\n| checkFee | ✅ | N/A | N/A | poll ✅ |\n| info | ✅ | ✅ | ✅ | hello ✅ |\n| create | ✅ | ✅ | ✅ | keep-alive ✅ |\n| createDNSSEC | ✅ | N/A | N/A | new password ✅ |\n| createClaims | ✅ | N/A | N/A | |\n| update | N/A | ✅ | ✅ | |\n| updateNS | ✅ | N/A | N/A | |\n| updateContact | ✅ | N/A | N/A | |\n| updateAuthinfo | ✅ | ✅ | N/A | |\n| updateStatus | ✅ | ✅ | ✅ | |\n| updateDNSSEC | ✅ | N/A | N/A | |\n| renew | ✅ | N/A | N/A | |\n| delete | ✅ | ✅ | ✅ |  |\n| transferRequest | ✅ | ✅ | N/A | |\n| transferQuery | ✅ | ✅ | N/A | |\n| transferApprove | ✅ | ✅ | N/A | |\n| transferReject | ✅ | ✅ | N/A | |\n| transferCancel | ✅ | ✅ | N/A | |\n| rgp:restore | ✅ | N/A | N/A | |\n| rgp:report | ✅ | N/A | N/A | |\n\n### Supported Connection Types\n\n| type | status |\n|----------|----------|\n| EPP over TLS/TCP | ✅ |\n| EPP over HTTPS | ✅ |\n| RPP | 🚧 |\n| RRI | ✅ |\n| TMCH | ✅ |\n| REGRR | ❌ |\n\n### Registry Support (41 backends and counting)\n\n| Registry | TLDs | Extension | Status | TODO |\n|----------|----------|----------|----------|----------|\n| Generic RFC EPP | any | | ✅ | |\n| AFNIC | .fr/others | FR | ✅ | |\n| CARNET | .hr | HR | ✅ | |\n| Caucasus Online | .ge | GE | ✅ | |\n| CentralNic | all | | ✅ | |\n| CoCCA | all | | ✅ | |\n| CORE/Knipp | all | | ✅ | |\n| DENIC | .de | | ✅ | |\n| Domicilium | .im | | ✅ | |\n| DOMREG | .lt | LT | ✅ | |\n| DRS.UA | all | | ✅ | |\n| EURid | .eu | EU | ✅ | |\n| FORTH-ICS | .gr, .ελ | GR | ✅ | |\n| FRED | .cz/any | FRED | ✅ | domain update NS/DNSSEC |\n| GoDaddy Registry | all | | ✅ | |\n| Google Nomulus | all | | ✅ | |\n| Hostmaster | .ua | UA | ✅ | |\n| Identity Digital | all | | ✅ | |\n| IIS | .se, .nu | SE | ✅ | |\n| Internet.ee | .ee | EE | ✅ | |\n| ISNIC | .is | IS | ✅ | |\n| IT.COM | all | | ✅ | |\n| HKIRC | .hk | HK | ✅ | |\n| NASK | .pl | PL | ✅ | |\n| Namingo | all | | ✅ | |\n| NIC Chile | .cl | | ✅ | |\n| NIC Mexico | .mx | MX | ✅ | |\n| NIC.LV | .lv | LV | ✅ | |\n| NORID | .no | NO | ✅ | |\n| .PT | .pt | PT | ✅ | |\n| Registro.it | .it | IT | ✅ | |\n| Regtons | all | | ✅ | |\n| RoTLD | .ro | | ✅ | |\n| RyCE | all | | ✅ | |\n| SIDN | all | | ✅ | |\n| SWITCH | .ch, .li | | ✅ | |\n| Traficom | .fi | FI | ✅ | |\n| Tucows Registry | all | | ✅ | |\n| Verisign | all | VRSN | ✅ | |\n| ZADNA | .za |  | ✅ | |\n| ZDNS | all |  | ✅ | |\n\n### Integration with billing systems\n\nWould you like to see any registry added as a WHMCS/FOSSBilling module? Or an EPP module for any other billing system? Simply create an [issue](https://github.com/getnamingo/epp-client/issues) in this project and let us know.\n\n| Platform | TLDs | Project |\n|----------|----------|----------|\n| WHMCS EPP Registrar | any | [whmcs-epp-registrar](https://github.com/getnamingo/whmcs-epp-registrar) |\n| FOSSBilling EPP Registrar | any | [fossbilling-epp-registrar](https://github.com/getnamingo/fossbilling-epp-registrar) |\n\n## Installation\n\nTo begin, follow these steps for setting up the EPP Client. This installation process is optimized for a VPS running Ubuntu 22.04/24.04 or Debian 12/13.\n\n### 1. Install PHP\n\n#### Ubuntu 22.04 / 24.04\n\n```bash\napt update\napt install -y curl software-properties-common ufw\n\nadd-apt-repository -y ppa:ondrej/php\napt update\n\napt install -y \\\n  composer git net-tools unzip wget whois \\\n  php8.3-bz2 php8.3-cli php8.3-common php8.3-curl \\\n  php8.3-gmp php8.3-intl php8.3-mbstring php8.3-xml\n```\n\n#### Debian 12 / 13\n\n```bash\napt update\napt install -y ca-certificates curl gnupg lsb-release ufw\n\ncurl -fsSL https://packages.sury.org/php/apt.gpg \\\n  | gpg --dearmor -o /usr/share/keyrings/sury-php.gpg\n\necho \"deb [signed-by=/usr/share/keyrings/sury-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main\" \\\n  \u003e /etc/apt/sources.list.d/sury-php.list\n\napt update\n\napt install -y \\\n  composer git net-tools unzip wget whois \\\n  php8.3-bz2 php8.3-cli php8.3-common php8.3-curl \\\n  php8.3-gmp php8.3-intl php8.3-mbstring php8.3-xml\n```\n\n### 2. Install EPP Client Package\n\nNavigate to your project directory and run the following command:\n\n```bash\ncomposer require pinga/tembo\n```\n\n### 3. Configure Access to the Registry\n\nEdit the `examples/Connection.php` file to configure your registry access credentials (host, port, username, password, certificates, etc.).\n\nIf the registry requires SSL certificates and you don't have them, refer to the troubleshooting section for steps to generate `cert.pem` and `key.pem`.\n\n### 4. Detailed Logging\n\nThe EPP Client supports full logging of raw XML commands and responses via a PSR-3 compatible logger. For detailed debugging (including `\u003ccommand\u003e` and `\u003cresponse\u003e` XML), we recommend using Monolog.\n\nRun this in your project root:\n\n```bash\ncomposer require monolog/monolog\n```\n\nCheck `examples/Connection.php` for details on how to enable logger. Make sure you have `use` statements for the selected package.\n\n## Using the EPP Client\n\n- You can use the commands provided in the `examples` directory to interact with the EPP server.\n\n- Alternatively, include the `Connection.php` file in your project and build your custom application using the `EppClient` class and its functions.\n\n## Troubleshooting\n\n### EPP Server Access\n\nIf you're unsure whether your system can access the EPP server, you can test the connection using OpenSSL. Try one or both of the following commands:\n\n1. Basic Connectivity Test:\n\n```bash\nopenssl s_client -showcerts -connect epp.example.com:700\n```\n\n2. Test with Client Certificates:\n\n```bash\nopenssl s_client -connect epp.example.com:700 -CAfile cacert.pem -cert cert.pem -key key.pem\n```\n\nReplace `epp.example.com` with your EPP server's hostname and adjust the paths to your certificate files (`cacert.pem`, `cert.pem`, and `key.pem`) as needed. These tests can help identify issues with SSL/TLS configurations or network connectivity.\n\n### Generating an SSL Certificate and Key\n\nIf you do not have an SSL certificate and private key for secure communication with the registry, you can generate one using OpenSSL.\n\n```bash\nopenssl genrsa -out key.pem 2048\nopenssl req -new -x509 -key key.pem -out cert.pem -days 365\n```\n\n**Note:** For production environments, it's recommended to use a certificate signed by a trusted Certificate Authority (CA) instead of a self-signed certificate.\n\n### EPP-over-HTTPS Issues\n\nIf you experience login or other issues with EPP-over-HTTPS registries such as `.eu`, `.fi`, `.hr`, `.it`, or `.lv`, it might be caused by a corrupted or outdated cookie file. Follow these steps to fix it:\n\n```bash\nrm -f /tmp/eppcookie.txt\n```\n\nAfter deleting the cookie file, try logging in again. This will force the creation of a new cookie file and may resolve the issue.\n\n### Need More Help?\n\nIf the steps above don’t resolve your issue, refer to the EPP Client logs (`/path/to/tembo/log`) to identify the specific problem.\n\n## Benchmarking an EPP Server\n\nTo run tests against an EPP server using the Namingo EPP client, follow these steps:\n\n### 1. Configure Your Connection\n\nEdit the file `benchmark/Connection.php` - this file should contain the connection details for the server you want to test. It uses the same format as `examples/Connection.php`.\n\n### 2. Run the Benchmark\n\nFrom the root directory, run `php benchmark/Benchmark.php` - this will execute a series of domain check commands to test your server’s response and performance.\n\n### 3. Customize the Benchmark\n\nYou can modify `benchmark/Benchmark.php` to:\n- Add your own EPP commands\n- Change the number of requests\n- Adjust the test logic\n\nUse this script as a starting point to test and tune your EPP server setup.\n\n## Support\n\nYour feedback and inquiries are invaluable to Namingo's evolutionary journey. If you need support, have questions, or want to contribute your thoughts:\n\n- **Email**: Feel free to reach out directly at [help@namingo.org](mailto:help@namingo.org).\n\n- **Discord**: Or chat with us on our [Discord](https://discord.gg/97R9VCrWgc) channel.\n  \n- **GitHub Issues**: For bug reports or feature requests, please use the [Issues](https://github.com/getnamingo/epp-client/issues) section of our GitHub repository.\n\n- **GitHub Discussions**: For general discussions, ideas, or to connect with our community, visit the [Discussion](https://github.com/getnamingo/epp-client/discussions) page on our GitHub project.\n\nWe appreciate your involvement and patience as Namingo continues to grow and adapt.\n\n## Support This Project\n\nIf you find Namingo EPP Client useful, consider donating:\n\n- [Donate via Stripe](https://donate.stripe.com/7sI2aI4jV3Offn28ww)\n- BTC: `bc1q9jhxjlnzv0x4wzxfp8xzc6w289ewggtds54uqa`\n- ETH: `0x330c1b148368EE4B8756B176f1766d52132f0Ea8`\n\n## Licensing\n\nNamingo EPP Client is licensed under the MIT License.","funding_links":["https://donate.stripe.com/7sI2aI4jV3Offn28ww","https://www.blockchain.com/btc/address/bc1q9jhxjlnzv0x4wzxfp8xzc6w289ewggtds54uqa","https://etherscan.io/address/0x330c1b148368EE4B8756B176f1766d52132f0Ea8"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetnamingo%2Fepp-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetnamingo%2Fepp-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetnamingo%2Fepp-client/lists"}