TESTS.md

Swoole Tests

Core Tests

Used to test the core code in the src/ directory, only as a C++ library, not related to php. The core tests depends on the googletest framework, and googletest needs to be installed. The core test cases must be written with C++.

Build libswoole.so

cd swoole-src
cmake .
make -j$(nproc)

Export source directory

SWOOLE_DIR=/your/path/to/swoole-src

Build core-tests

cd core-tests
cmake .
make -j$(nproc)

Run core-tests

# run all tests
./bin/core-tests
# run some test cases
./bin/core-tests --gtest_filter=server.*
# list all tests
./bin/core_tests --gtest_list_tests

PHP Tests

Used to test the php extension code in the ext-src/ directory. The swoole php test depends on php environment. The php-dev related components must be installed.

The php test cases must be written with PHP.

Build ext-swoole

cd swoole-src
phpize
./configure ${options}
make -j$(nproc)
make install

Need to configure php.ini, add extension=swoole.so to enable ext-swoole.

Run tests

./scripts/route.sh

The automated test scripts in this directory can not only run on Github Action CI. Powered by docker container technology, it can run on any systems. You only need to run the route.sh script to create containers of multiple PHP environments then it will run Swoole's build tests and unit tests on multiple systems automatically.

With special branch

SWOOLE_BRANCH=alpine ./scripts/route.sh

Enter the container

You can cancel the unit test by CTRL+C

docker exec -it -e LINES=$(tput lines) -e COLUMNS=$(tput cols) swoole /bin/bash