Download the PHP package aerospike/aerospike-php without Composer
On this page you can find all versions of the php package aerospike/aerospike-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package aerospike-php
Aerospike PHP 8 Client (v1.2.0)
An Aerospike client library for PHP 8
PHP-Client Introduction
This is the documentation for the Aerospike PHP-Client. The PHP-Client comprises of two essential components:
- the client itself, written in Rust as a PHP extension
- the connection manager (the "Aerospike Connection Manager" or "ACM") written in Go which serves as a shared resource among PHP processes. The ACM efficiently handles all requests and responses between the PHP processes and the Aerospike server, and can be configured to run as a daemonized service.
Dependencies
NOTE: Any missing dependencies will be installed by the installation script
- PHP (v8.1-8.4)
- Cargo (Rust package manager)
- Aerospike server
- Linux or MacOS (Darwin)
- PHPUnit
- rustc (Rust compiler) >= v1.74
- Go Toolchain Go Toolchains - The Go Programming Language
- Protobuf Compiler protoc-gen-go command - google.golang.org/protobuf/cmd/protoc-gen-go - Go Packages
- ext-php-rs (PHP extension) v0.13.1 github repository link
Build & Installation
There are 2 ways to build and install the PHP-Client:
- direct script download and execution (also clones the repo for you)
- manually clone the repo first and then run script from there
The install script builds both the PHP-Client and the ACM, as well as installing all of the dependencies.
Automatic Method: Direct download and execution of installation script:
The installation script will clone the repo into a subfolder so execute this command directly above where you want the repo to go
For MacOS (Darwin):
NOTE: the default MacOS installation is an all user-local installation, requiring no root or sudo access
For Linux:
Manual method: repo clone followed by execution of the installation script:
- Clone the repo
-
Run the installation script for your system:
for MacOS (darwin):
or for linux:
NOTE: the default linux installation contains system-wide installations and will require root / sudo access
After the installation script completes, re-source your shell env config files to make sure your PATH is updated. Eg, on MacOS:
If you encounter errors during installation, you can try running the install script again as the install scripts attempt to be idempotent. As a last resort, the script commands can be run manually one-by-one as needed.
Configuring the Aerospike Connection Manager:
NOTE: Please view the README.md in the php-client/aerospike-connection-manager directory for more information about the setting up the aerospike-connection-manager and configuring the client policy.
NOTE: You should have an Aerospike server up and running to test against.
Manual Build and Install of the PHP-Client (optional)
In case the installation script fails to build the PHP-Client, or if you just want to run specific build commands, you may do so manually:
-
To manually build and install the
PHP-Clientin the default paths run the makefileNote: sudo is only needed when running a system-wide php installation, which is not the default install for MacOS (although it could be)
-
To build and install the
PHP-Clientin manually, run the following commands: - Once the build is successful, copy the file from
target/release/libaerospike$(EXTENSION)[$EXTENSION = .so for Linux and .dylib for Mac and Windows] to the PHP extension directory path. - Add
extension=libaerospike$(EXTENSION)to yourphp.inifile. - Run
phpunit tests/to ensure the setup and build were successful.
NOTE: The Aerospike server must be running for the tests to run successfully.
Running your PHP Project
- Before running your project PHP scripts, the following must be running:
- An Aerospike Connection Manager (ACM)
- An Aerospike Server that the ACM can connect to
-
Once the build is successful and all the pre-requisites are met, import the Aerospike namespace to your PHP script:
-
To connect to the Aerospike server via the ACM add:
-
Run the php script If there are no Errors then you have successfully connected to the Aerospike DB.
NOTE: If the connection manager daemon crashes, you will have to manually remove the file
/tmp/asld_grpc.sockfrom its path. - Policy Configuration (Read, Write, Batch and Info) - These policies can be set via getters and setter in the php code. On creation of an object of that policy class (eg, WritePolicy), the default values are initialized for that policy & can be overidden with associated setters. For example:
Documentation
- Reference Documentation can be found [here] (https://aerospike.github.io/php-client/)
- Aerospike Documentation can be found here
Issues
If there are any bugs, feature requests or feedback -> please create an issue on GitHub. Issues will be regularly reviewed by the Aerospike Client Engineering Team.
Usage
The following is a very simple example of CRUD operations in an Aerospike database.
Batch Operations Examples:
For more detailed examples you can see the examples direcotry php-client/examples
