Connect PHP to Redis | Predis and PhpRedis Tutorial

# CHAPTER 15

Redis with PHP Applications #

1. Introduction #

2. Learning Objectives #

• Understand the difference between PhpRedis and Predis.

• Connect to the Redis server via PHP.

• Execute basic SET and GET commands programmatically.

• Serialize complex PHP arrays to JSON for Redis storage.

• Architect a basic Database Query Caching layer.

3. The Two PHP Clients #

1. 1. PhpRedis: A compiled C-extension. It is incredibly fast but requires you to modify your server's core PHP installation.

1. 2. Predis: A pure PHP library installed via Composer. It is slightly slower, but incredibly easy to install and heavily favored by modern frameworks like Laravel.

*For this tutorial, we will use the syntax of PhpRedis (the official Redis class).*

4. Establishing the Connection #

<?php
// 1. Instantiate the Redis Object
$redis = new Redis();

// 2. Connect to the local server on the default port
try {
    $redis->connect(&#039;127.0.0.1', 6379);
    
    // If you set a password in Chapter 14, authenticate here:
    // $redis->auth('zx92!PqR5$mK8#vL1@bN4%cX7^hJ0&wY3*');
    
    echo "Successfully connected to Redis!<br>";
} catch (Exception $e) {
    die("Could not connect to Redis: " . $e->getMessage());
}
?>

5. Executing Basic Commands #

<?php
// SET a string
$redis->set("company_name", "TechCorp Inc.");

// GET a string
$name = $redis->get("company_name");
echo $name; // Outputs: TechCorp Inc.

// Execute an Atomic INCR
$redis->incr("page_views");
echo "Views: " . $redis->get("page_views");

// Set with Expiration (SETEX)
$redis->setex("temporary_code", 300, "9999");
?>

6. Serializing PHP Arrays #

<?php
$user_profile = [
    "name" => "Alice",
    "email" => "alice@example.com",
    "role" => "Admin"
];

// Flatten the array to a JSON string
$json_string = json_encode($user_profile);

// Store it in Redis
$redis->set("user:101", $json_string);

// Retrieve and Decode it back to an Array
$stored_string = $redis->get("user:101");
$retrieved_array = json_decode($stored_string, true);

echo $retrieved_array[&#039;email']; // Outputs: alice@example.com
?>

7. Mini Project: The Query Caching Layer #

<?php
$product_id = 55;
$cache_key = "product_data:" . $product_id;

// 1. Try to fetch from Redis
$cached_data = $redis->get($cache_key);

if ($cached_data) {
    echo "Served blazing fast from Redis Cache!<br>";
    $product = json_decode($cached_data, true);
} else {
    echo "Cache Miss! Fetching from slow MySQL database...<br>";
    
    // 2. Simulate a slow MySQL Query
    // $db_result = mysqli_query($conn, "SELECT * FROM products WHERE id=55");
    $db_result = ["id" => 55, "name" => "Laptop", "price" => 1200]; 
    
    // 3. Save the result into Redis for 10 minutes (600 seconds)
    $redis->setex($cache_key, 600, json_encode($db_result));
    
    $product = $db_result;
}

echo "Displaying Product: " . $product[&#039;name'];
?>

8. PHP Session Storage in Redis #

session.save_handler = redis
session.save_path = "tcp://127.0.0.1:6379"

Now, sessionstart() executes perfectly at the speed of light across your entire cluster of servers.

• Forgetting to serialize data: A beginner tries to run $redis->set("myarray", [1, 2, 3]);. PHP will throw a severe warning, and the data will not be saved properly. Redis requires strictly Strings, Hashes, Sets, etc. You must run jsonencode on complex variables before using the SET command.

1. 2. What specific configuration file must you edit to force PHP to handle global $SESSION data using the Redis engine rather than local hard drive files?

12. Redis Challenges #

14. Interview Questions #

• Q: Write a conceptual PHP script utilizing a try/catch block that connects to Redis, attempts to fetch a cached string, and gracefully degrades to a simulated SQL query fallback if the Redis connection times out.

• Q: Explain the mechanical differences between the PhpRedis C-extension and the Predis package. Why might a DevOps engineer working in a highly restricted containerized environment prefer Predis?

15. FAQs #

16. Summary #

17. Next Chapter Recommendation #