PHP extension to communicate with any AMQP compliant server
Object-oriented PHP bindings for the AMQP C library (https://github.com/alanxz/rabbitmq-c)
Some systems has php-amqp extension in their repo or available via external repositories, so it is MAY be the preferable way to install.
RPM packages are available in Fedora and EPEL (for RHEL and CentOS) official repositories, see php-pecl-amqp
librabbitmqRPMs available via remi repo.
rabbitmq.4.pdbfiles to the PHP root folder and copy
There are also available stub files with accurate PHPDoc which may be also used in your IDE for code completion, navigation and documentation in-place.
Finally, check out the tests to see typical usage and edge cases.
Max channels per connection means how many concurrent channels per connection may be opened at the same time (this limit may be increased later to max AMQP protocol number - 65532 without any problem).
Nested header arrays may contain only string values.
You can't share none of AMQP API objects (none of
AMQPExchange) between threads. You have to use separate connection and so on per thread.
Developers note: alternatively for built-in persistent connection support raphf pecl extension may be used.
Some of them, the list is not complete.
amqp.dllif you are on windows), it is loaded (
php --ri amqpproduced some info), and there are no underlying abstraction that MAY emulate php-amqp work.
There is a Vagrant environment with pre-installed software and libraries necessary to build, test and run the php-amqp extension.
To start it, just type
vagrant upand then
vagrant sshin php-amqp directory.
Services available out of the box are:
Additional tools are pre-installed to make development process as simple as possible:
Valgrind is ready to help find memory-related problems if you
export TEST_PHP_ARGS=-mbefore running tests.
phpbrew waits to help you to test extension on various PHP versions.
phpbrew install 5.6 +debug+default+fpmis a nice start. To switch to some version just use
To start php-fpm just run
phpbrew fpm start(don't forget to run
sudo service stop php5-fpmbefor).
This development environment out of the box ready for php-fpm and cli extension usage, if need to test it when php used as apache module, refer to Apache2 support on phpbrew wiki. Keep in mind that
+fpmand it is a bit tricky to specify which libphp .so will be loaded.
tshark - Dump and analyze network traffic
... TShark is able to detect, read and write the same capture files that are supported by Wireshark.
To use it you probably have to set network privileges for dumpcap first(see Platform-Specific information about capture privileges Wireshark docs page and running wireshark “Lua: Error during loading” SO question):
sudo setcap 'CAP_NET_RAW+eip CAP_NET_ADMIN+eip' /usr/bin/dumpcap
To start capturing, run
tshark -i loto see output in terminal or
tshark -i lo -w capture.logto save capture and analyze it later (even with AMQP protocol Wireshark plugin). You may filter AMQP packages using
-Y amqpattribute, just give a try -
tshark -i lo -Y amqp.
NOTE: -w provides raw packet data, not text. If you want text output you need to redirect stdout (e.g. using '>'), don't use the -w option for this.
sudo curl https://raw.githubusercontent.com/rabbitmq/rabbitmq-server/master/docs/rabbitmq.config.example /etc/rabbitmq/rabbitmq.config
To reset RabbitMQ application run in CLI (as privileged user)
rabbitmqctl stop_app && rabbitmqctl reset && rabbitmqctl start_app.
It is a good practice to keep php processes (i.e workers/consumers) under control. Usually, system administrators write their own scripts which ask services about current status or performs some desired actions. Usually request is sent via UNIX signals.
Because amqp consume method is blocking, pcntl extension seems to be useless.
Say we want to release "1.1000.0" next. We first run
php tools/make-release.php 1.1000.0. This will update the version numbers and pre-populate the changelog with the latest git commits between the previous version and now. It will prompt you to edit the changelog in between. Once the release is done it tells you what to do next. Run
php tools/make-dev.php 1.1000.1to bring master back into development mode afterwards.