fakerandom extension for PHP

PHP extension that mocks random_int & random_bytes for testing purposes.

Installation

Docker

FROM php:8.5
RUN curl -L https://github.com/valtzu/php-fakerandom/releases/download/v0.1.6/fakerandom_20250925.so > /usr/local/lib/php/extensions/no-debug-non-zts-20250925/fakerandom.so ;\
    docker-php-ext-enable fakerandom

Usage

random_int

fake_random_enable();
echo random_int(1, 3); // will be always 1 + (3 - 1) / 2 = 2

fake_random_disable();
echo random_int(1, 3); // original functionality restored

random_bytes

fake_random_enable();
echo bin2hex(random_bytes(3)); // will be always 010203 (goes up until "ff" and then "00" again)

fake_random_disable();
echo bin2hex(random_bytes(3)); // original functionality restored

Build & test

docker-compose up --build