Valkey - Connect with PHP

Learn how to connect to a Valkey service with one of the world's most famous programming languages: PHP.

Cloud Databases allow you to focus on building and deploying cloud applications while OVHcloud takes care of the database infrastructure and maintenance in operational conditions.

You can find an example in the GitHub examples repository.

Requirements

• Access to the OVHcloud Control Panel
• A Public Cloud project in your OVHcloud account
• A Valkeyservice running on your OVHcloud Cloud Databases (this guide can help you to meet this requirement)
• Configure your Valkey service to accept incoming connections
• A PHP environment with a stable version and public network connectivity (Internet). This guide was made in PHP 7.4

Concept

A Valkey service can be managed in multiple ways. One of the easiest, yet powerful, is to use a Command Line Interface (CLI), as shown in our guide: Connect with CLI.

Another way is to interact directly using programming languages, such as PHP. PHP is used in almost 80% of the websites in the world, such as Facebook, Wikipedia or WordPress. Redis® has multiple PHP clients, allowing us to connect and manage an instance from code. Please follow the official Redis® documentation for PHP clients to get the latest information for all clients.

We will need to set up our PHP environment with the phpredis client, configure our Cloud Databases for Valkey services to accept incoming connections, and finally code in PHP to perform a few example actions.

Instructions

Set up your PHP environment

To interact with your instance with PHP, your development environment needs to be configured with:

• A compatible version of PHP;
• PHP extension that supports Redis® open source software version 6 and TLS, as recommended by Redis®: phpredis or Predis PHP Libraries.

For both phpredis and Predis it is recommended to check their respective sites on how to do the installation:

• phpredis official GitHub
• Predis official GitHub

We are now ready to learn how to connect to our instance. We will use phpredis as the PHP client.

Connect with PHP

In your PHP environment, let's try a connection. To be sure that we are indeed connected, set a data pair, and then check that we can get the value of it.

<?php
   // PHP version 7.4 used here
    echo "\nConnection to server ongoing...";
    $redis = new Redis() or die("Cannot load Redis module in PHP.");

    // Connection to the Redis DB
    $redis->connect('tls://<host name>', <port>);

    // Setup the user
    $redis->auth(['<username>', '<password>']);

    // Ping the instance
    echo "\nServer is running: ".$redis->ping("OK");

    // Set the key pair
    echo "\nSet key pair (foo,cowabunga).";
    $redis->set('foo', 'cowabunga');

    // Get the value of the key foo
    $response = $redis->get('foo');
    echo "\nGet the value for key foo :";
    echo $response;

    if ($response == "cowabunga") {
        echo "\nPHP test with Redis OK.\n";
    } else {
        echo "\nPHP Test FAILED\n";
    }
?>

Go further

Browse all the Databases guides.

Browse the rest of the OVHcloud US documentation for guides on our other products and services.

Learn more about Managed Databases on the OVHcloud US website.