PHP client guide

Run Memgraph

If you're new to Memgraph or you're in a developing stage, we recommend using the Memgraph Platform. Besides the database, it also includes all the tools you might need to analyze your data, such as command-line interface mgconsole, web interface Memgraph Lab and a complete set of algorithms within a MAGE library.

Ensure Docker (opens in a new tab) is running in the background. Depending on your operating system, execute the appropriate command in the console:

For Linux and macOS:

curl https://install.memgraph.com | sh

For Windows:

iwr https://windows.memgraph.com | iex

The command above will start Memgraph Platform, which includes Memgraph database, Memgraph Lab and Memgraph MAGE. Memgraph uses Bolt protocol to communicate with the client using the exposed 7687 port. Memgraph Lab is a web application you can use to visualize the data. It's accessible at http://localhost:3000 (opens in a new tab) if Memgraph Platform is running correctly. The 7444 port enables Memgraph Lab to access and preview the logs, which is why both of these ports need to be exposed.

For more information visit the getting started guide on how to run Memgraph with Docker.

Create a directory

Next, create a new directory for your application, for example hello-memgraph and position yourself in it.

mkdir hello-memgraph
cd hello-memgraph

Create PHP script

Create index.php file and add the following code to it:

<?php
require_once(__DIR__."/vendor/autoload.php");
 
// Create a connection class and specify target host and port, default is localhost.
$conn = new \Bolt\connection\Socket();
// Create a new Bolt instance and provide connection object.
$bolt = new \Bolt\Bolt($conn);
// Set available Bolt versions for Memgraph.
$bolt->setProtocolVersions(5.2);
// Build and get protocol version instance which creates connection and executes handshake.
$protocol = $bolt->build();
// Login to database with credentials.
$protocol->hello();
$protocol->logon(\Bolt\helpers\Auth::basic('', ''));
 
// Pipeline two messages. One to execute query with parameters and second to pull records.
$protocol
    ->run('CREATE (a:Greeting) SET a.message = $message RETURN id(a) AS nodeId, a.message AS message', ['message' => 'Hello, World!'])
    ->pull();
 
// Server responses are waiting to be fetched through iterator.
$rows = iterator_to_array($protocol->getResponses(), false);
// Get content from requested record.
$row = $rows[1]->getContent();
 
echo 'Node ' . $row[0] . ' says: ' . $row[1];
?>

$bolt = new \Bolt\Bolt($conn);
$bolt->setProtocolVersions(4.3, 4.1, 4.2);
$protocol->hello(\Bolt\helpers\Auth::basic('', ''));

Install the PHP library

Make sure you are located in the hello-memgraph folder in the terminal. Then, run a composer command to get the required library:

composer require stefanak-michal/bolt

That command will create composer.json file.

Run the application

To run the application, run the following command in terminal:

php -S localhost:4000

Open you browser, enter localhost:4000 as URL and you should see an output similar to the following:

Node 0 says: Hello, World!

{
    "require": {
        "stefanak-michal/bolt": "6.1.3"
    }, 
    "scripts": {
        "start": "php -S localhost:4000"
    },
    "config": {
        "allow-plugins": {
            "php-http/discovery": true
        }
    }
}

Visualize data

To visualize objects created in the database with the index.php script, head over to http://localhost:3000/ (opens in a new tab) and run MATCH (n) RETURN n; in the Query Execution tab. That query will visualize the created node. By clicking on a node, you can explore different properties.

Next steps

This guide makes a good starting point when building PHP applications. Check out the PHP Bolt driver repository (opens in a new tab) to learn more about using the PHP Bolt library.

You can simplify the usage of this library with the Memgraph Bolt wrapper (opens in a new tab).