fakerandom extension for PHP

PHP extension that mocks random_int & random_bytes for testing purposes.

Installation

Docker

FROM php:8.3
RUN curl -L https://github.com/valtzu/php-fakerandom/releases/download/v0.1.4/fakerandom_20230831.so > /usr/local/lib/php/extensions/no-debug-non-zts-20230831/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