https://github.com/msgpack/msgpack-php
msgpack.org[PHP]
https://github.com/msgpack/msgpack-php
Last synced: 9 months ago
JSON representation
msgpack.org[PHP]
- Host: GitHub
- URL: https://github.com/msgpack/msgpack-php
- Owner: msgpack
- License: bsd-3-clause
- Created: 2012-08-20T12:52:29.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2024-09-26T08:33:35.000Z (over 1 year ago)
- Last Synced: 2025-05-14T04:12:35.262Z (9 months ago)
- Language: PHP
- Homepage:
- Size: 943 KB
- Stars: 787
- Watchers: 64
- Forks: 118
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Msgpack for PHP
[](https://github.com/msgpack/msgpack-php/actions?query=workflow%3Aci+branch%3Amaster)
This extension provides an API for communicating with MessagePack serialization.
MessagePack is a binary-based efficient object serialization library.
It enables to exchange structured objects between many languages just like JSON.
But unlike JSON, it is very fast and small.
## Requirement
- PHP 7.0 +
## Install
### Install from PECL
Msgpack is a PECL extension, thus you can simply install it by:
```shell
pecl install msgpack
```
### Compile Msgpack from source
```shell
/path/to/phpize
./configure --with-php-config=/path/to/php-config
make && make install
```
### Example
```php
1, 1 => 2, 2 => 3);
$msg = msgpack_pack($data);
$data = msgpack_unpack($msg);
```
### Advanced Example
```php
1, 1 => 2, 2 => 3);
$packer = new \MessagePack(false);
// ^ same as $packer->setOption(\MessagePack::OPT_PHPONLY, false);
$packed = $packer->pack($data);
$unpacker = new \MessagePackUnpacker(false);
// ^ same as $unpacker->setOption(\MessagePack::OPT_PHPONLY, false);
$unpacker->feed($packed);
$unpacker->execute();
$unpacked = $unpacker->data();
$unpacker->reset();
```
### Advanced Streaming Example
```php
1, 1 => 2, 2 => 3);
$data2 = array("a" => 1, "b" => 2, "c" => 3);
$packer = new \MessagePack(false);
$packed1 = $packer->pack($data1);
$packed2 = $packer->pack($data2);
$unpacker = new \MessagePackUnpacker(false);
$buffer = "";
$nread = 0;
//Simulating streaming data :)
$buffer .= $packed1;
$buffer .= $packed2;
while(true) {
if($unpacker->execute($buffer, $nread)) {
$msg = $unpacker->data();
var_dump($msg);
$unpacker->reset();
$buffer = substr($buffer, $nread);
$nread = 0;
if(!empty($buffer)) {
continue;
}
}
break;
}
```
## Resources
* [msgpack](http://msgpack.org/)