PHPackages centrifugal/phpcent - 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. [HTTP & Networking](/categories/http) 4. / 5. centrifugal/phpcent ActiveLibrary[HTTP & Networking](/categories/http) centrifugal/phpcent =================== PHP library to communicate with Centrifugo HTTP API 6.0.1(1y ago)1822.3M—3.3%36[1 issues](https://github.com/centrifugal/phpcent/issues)[2 PRs](https://github.com/centrifugal/phpcent/pulls)4MITPHPPHP >=7.0.0 Since Jun 15Pushed 1y ago5 watchersCompare [ Source](https://github.com/centrifugal/phpcent)[ Packagist](https://packagist.org/packages/centrifugal/phpcent)[ Docs](https://github.com/centrifugal/phpcent)[ GitHub Sponsors](https://github.com/centrifugal)[ RSS](/packages/centrifugal-phpcent/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (9)Dependencies (1)Versions (24)Used By (4) phpcent ======= [](#phpcent) [![Build Status](https://github.com/centrifugal/phpcent/workflows/test/badge.svg?branch=master)](https://github.com/centrifugal/phpcent/actions)[![Latest Version](https://camo.githubusercontent.com/3605fe4d9a8b32914ba003c21ff18bbd8b72132c974c6e30845c11cf5557fc03/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f63656e747269667567616c2f70687063656e742e7376673f7374796c653d666c61742d737175617265)](https://github.com/centrifugal/phpcent/releases) PHP library to communicate with Centrifugo v5 HTTP API (for Centrifugo v4 use phpcent v5.x, for Centrifugo v3 use phpcent v4.x). Library is published on the Composer: ``` composer require centrifugal/phpcent:~6.0 ``` See [Centrifugo server API documentation](https://centrifugal.dev/docs/server/server_api). Basic Usage: ``` $client = new \phpcent\Client("http://localhost:8000/api"); $client->setApiKey("Centrifugo API key"); $client->publish("channel", ["message" => "Hello World"]); ``` You can use `phpcent` to create connection token (JWT): ``` $token = $client->setSecret("Centrifugo secret key")->generateConnectionToken($userId); ``` Connection token that will be valid for 5 minutes: ``` $token = $client->setSecret("Centrifugo secret key")->generateConnectionToken($userId, time() + 5*60); ``` It's also possible to generate channel subscription token: ``` $token = $client->setSecret("Centrifugo secret key")->generateSubscriptionToken($userId, $channel); ``` It's also possible to generate channel subscription token with expiration time, for example token for 30 mins: ``` $token = $client->setSecret("Centrifugo secret key")->generateSubscriptionToken($userId, $channel, time() + 30*60); ``` Also API key and secret can be set in constructor: ``` $client = new \phpcent\Client("http://localhost:8000/api", "", ""); ``` Timeouts: ``` $client->setConnectTimeoutOption(0); // Seconds | 0 = never $client->setTimeoutOption(2); // Seconds ``` All available API methods: ``` $response = $client->publish($channel, $data); $response = $client->broadcast($channels, $data); $response = $client->unsubscribe($channel, $userId); $response = $client->disconnect($userId); $response = $client->presence($channel); $response = $client->presenceStats($channel); $response = $client->history($channel); $response = $client->historyRemove($channel); $response = $client->channels(); $response = $client->info(); ``` To use `assoc` option while decoding JSON in response: ``` $client->setUseAssoc(true); ``` ### SSL [](#ssl) In case if your Centrifugo server has invalid SSL certificate, you can use: ``` $client->setSafety(false); ``` You can also use self signed certificate in safe manner: ``` $client = new \phpcent\Client("https://localhost:8000/api"); $client->setCert("/path/to/certificate.pem"); $client->setCAPath("/ca/path"); // if you need. ``` *Note:* Certificate must match with host name in `Client` address (`localhost` in example above). ### DNS Resolution [](#dns-resolution) This error may indicate your system is having trouble resolving IPv6 addresses: ``` cURL error: Resolving timed out after [value] milliseconds ``` By default, both IPv4 and IPv6 addresses will attempt to be resolved. You can force it to only resolve IPv4 addresses with: ``` $client->forceIpResolveV4(); ``` ### Testing [](#testing) Requirements: - git - A supported version of PHP - [composer](http://getcomposer.org/download) - [Docker](https://www.docker.com/products/docker-desktop) The provided PHPUnit tests assume that a local [Centrifugo](https://github.com/centrifugal/centrifugo) server is running and available at port 8000. This can be accomplished using Docker and the [official Centrifugo image](https://hub.docker.com/r/centrifugo/centrifugo/). ``` # Install package dependencies. $ composer install # The following command starts a Centrifugo server running in a background Docker container. $ docker run -d -p 8000:8000 --name centrifugo centrifugo/centrifugo centrifugo --api_insecure # Run the test suite. $ vendor/bin/phpunit # Shut down the Centrifugo container. $ docker stop centrifugo ``` Authors ======= [](#authors) - [Dmitriy Soldatenko](https://github.com/sl4mmer) - [Dmitriy Tetekin](https://github.com/Tomchanskiy) ### Health Score 51 — FairBetter than 96% of packages Maintenance34 Infrequent updates — may be unmaintained Popularity59 Moderate usage in the ecosystem Community31 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~183 days Recently: every ~256 days Total 19 Last Release 690d ago Major Versions 1.0.5 → v2.x-dev2018-12-05 2.2.0 → 3.0.02019-05-14 3.1.1 → 4.0.02021-09-06 4.0.0 → 5.0.02022-09-29 5.1.0 → 6.0.02024-06-20 PHP version history (3 changes)0.5.0PHP >=5.3.0 3.0.2PHP >=5.4.0 4.0.0PHP >=7.0.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/9273a44311a83affa2bee70b36f618b27a251ed0bb8c1cf2551655122a9e1a34?d=identicon)[FZambia](/maintainers/FZambia) --- Top Contributors [![FZambia](https://avatars.githubusercontent.com/u/1196565?v=4)](https://github.com/FZambia "FZambia (47 commits)")[![sl4mmer](https://avatars.githubusercontent.com/u/1143307?v=4)](https://github.com/sl4mmer "sl4mmer (30 commits)")[![SteveTherrien](https://avatars.githubusercontent.com/u/9618303?v=4)](https://github.com/SteveTherrien "SteveTherrien (2 commits)")[![khvalov](https://avatars.githubusercontent.com/u/2668527?v=4)](https://github.com/khvalov "khvalov (2 commits)")[![Vovan-VE](https://avatars.githubusercontent.com/u/1166581?v=4)](https://github.com/Vovan-VE "Vovan-VE (2 commits)")[![beporter](https://avatars.githubusercontent.com/u/637270?v=4)](https://github.com/beporter "beporter (2 commits)")[![jumper572](https://avatars.githubusercontent.com/u/29145733?v=4)](https://github.com/jumper572 "jumper572 (2 commits)")[![xAockd](https://avatars.githubusercontent.com/u/3390348?v=4)](https://github.com/xAockd "xAockd (1 commits)")[![aleksraiden](https://avatars.githubusercontent.com/u/65920?v=4)](https://github.com/aleksraiden "aleksraiden (1 commits)")[![yagobski](https://avatars.githubusercontent.com/u/220980?v=4)](https://github.com/yagobski "yagobski (1 commits)")[![AntistressStore](https://avatars.githubusercontent.com/u/80528523?v=4)](https://github.com/AntistressStore "AntistressStore (1 commits)")[![BaBL86](https://avatars.githubusercontent.com/u/483972?v=4)](https://github.com/BaBL86 "BaBL86 (1 commits)")[![Darkkin](https://avatars.githubusercontent.com/u/8968720?v=4)](https://github.com/Darkkin "Darkkin (1 commits)")[![everlCode](https://avatars.githubusercontent.com/u/82755522?v=4)](https://github.com/everlCode "everlCode (1 commits)")[![juliustm](https://avatars.githubusercontent.com/u/3254503?v=4)](https://github.com/juliustm "juliustm (1 commits)")[![Tomchanskiy](https://avatars.githubusercontent.com/u/34372563?v=4)](https://github.com/Tomchanskiy "Tomchanskiy (1 commits)") --- Tags websocketmessagingrealtimecentrifugo ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/centrifugal-phpcent/health.svg) ``` [![Health](https://phpackages.com/badges/centrifugal-phpcent/health.svg)](https://phpackages.com/packages/centrifugal-phpcent) ``` ### Alternatives [pusher/pusher-php-server Library for interacting with the Pusher REST API 1.5k94.8M293](/packages/pusher-pusher-php-server)[sl4mmer/phpcent PHP library to communicate with Centrifugo HTTP API 182293.0k1](/packages/sl4mmer-phpcent)[denis660/laravel-centrifugo Centrifugo broadcaster for laravel 113164.7k](/packages/denis660-laravel-centrifugo)[basement-chat/basement-chat Add a real-time chat widget to your Laravel application. 4983.9k](/packages/basement-chat-basement-chat)[vinelab/minion A Simple WAMP (Web Application Messaging Protocol) server and command line tool 1276.4k](/packages/vinelab-minion)[takielias/codeigniter-websocket CodeIgniter Websocket using Ratchet Websocket technology. Inspired by https://github.com/romainrg/ratchet\_client 609.1k](/packages/takielias-codeigniter-websocket) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)