Skip to content

Commit

Permalink
add note about phprados to README
Browse files Browse the repository at this point in the history
  • Loading branch information
KurtThiemann committed Mar 22, 2024
1 parent 7f0b693 commit 6996d75
Showing 1 changed file with 12 additions and 0 deletions.
12 changes: 12 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,18 @@ An object oriented PHP library for using librados with FFI.
composer require aternos/rados-ffi
```

## Why not phprados?

The [phprados](https://github.com/ceph/phprados) extension is a native
PHP extension that provides bindings to librados. Unfortunately, it has been
largely unmaintained for the past few years. While it does compile for the latest version of PHP,
many of the included rados functions [do not work as intended and can cause crashes](https://github.com/ceph/phprados/pull/35).
Additionally, phprados only adds bindings for a small subset of the librados API.

php-rados-ffi provides a modern, object-oriented, and complete interface to librados using PHP's FFI system.
Through FFI, PHP can load shared libraries like librados and call their functions directly.
This allows using librados without a native PHP extension, making it easier to install and safer to update.

## Usage

Before the library can be used, the librados shared library must be loaded.
Expand Down

0 comments on commit 6996d75

Please sign in to comment.