Skip to content

Latest commit

 

History

History
 
 

tests

README.md

Phalcon Unit Tests

Welcome to the Phalcon Testing Suite.

This folder includes all the unit tests that test Phalcon components, ensuring that you enjoy a bug free framework.

Getting Started

This testing suite uses Travis CI for each run. Every commit pushed to this repository will queue a build into the continuous integration service and will run all tests to ensure that everything is going well and the project is stable.

The testing suite can be run on your own machine. The main dependency is Codeception which can be installed using Composer:

# run this command from project root
composer install --dev --prefer-source

You can read more about installing and configuring Codeception from the following resources:

A MySQL/PostgreSQL databases is also bundled in this suite. You can create a databases as follows:

MySQL

echo 'create database phalcon_test charset=utf8mb4 collate=utf8mb4_unicode_ci;' | mysql -u root
mysql -uroot phalcon_test < tests/_data/schemas/mysql/phalcon_test.sql

PostgreSQL

psql -c 'create database phalcon_test;' -U postgres
psql -U postgres phalcon_test -q -f tests/_data/schemas/postgresql/phalcon_test.sql

Note: For these MySQL-related we use the user root without a password. You may need to change this in codeception.yml file.

Obviously, Beanstalk-tests use Beanstalk, Memcached-tests use Memcached, etc.

We use the following settings of these services:

Beanstalk

  • Host: 127.0.0.1
  • Port: 11300

Memcached

  • Host: 127.0.0.1
  • Port: 11211

SQLite

  • DB Name: tests/_output/tests/phalcon_test.sqlite

MySQL

  • Host: 127.0.0.1
  • Port: 3306
  • Username: root
  • Password: '' (empty string)
  • DB Name: phalcon_test
  • Charset: utf8

PostgreSQL

  • Host: 127.0.0.1
  • Port: 5432
  • Username: postgres
  • Password: '' (empty string)
  • DB Name: phalcon_test

Mongo

  • Host: 127.0.0.1
  • Port: 27017
  • Username: admin
  • Password: '' (empty string)
  • DB Name phalcon_test

Redis

  • Host: 127.0.0.1
  • Port: 6379
  • DB Index 0

You can change the connection settings of these services before running tests by using environment variables:

# Beanstalk
export TEST_BT_HOST="127.0.0.1"
export TEST_BT_PORT="11300"

# Memcached
export TEST_MC_HOST="127.0.0.1"
export TEST_MC_PORT="11211"
export TEST_MC_WEIGHT="1"

# SQLite
export TEST_DB_SQLITE_NAME="/tmp/phalcon_test.sqlite"

# MySQL
export TEST_DB_MYSQL_DSN="mysql:host=localhost;dbname=phalcon_test"
export TEST_DB_MYSQL_HOST="127.0.0.1"
export TEST_DB_MYSQL_PORT="3306"
export TEST_DB_MYSQL_USER="root"
export TEST_DB_MYSQL_PASSWD=""
export TEST_DB_MYSQL_NAME="phalcon_test"
export TEST_DB_MYSQL_CHARSET="utf8"

# Postgresql
export TEST_DB_POSTGRESQL_HOST="127.0.0.1"
export TEST_DB_POSTGRESQL_PORT="5432"
export TEST_DB_POSTGRESQL_USER="postgres"
export TEST_DB_POSTGRESQL_PASSWD=""
export TEST_DB_POSTGRESQL_NAME="phalcon_test"

# Mongo
export TEST_DB_MONGO_HOST="127.0.0.1"
export TEST_DB_MONGO_PORT="27017"
export TEST_DB_MONGO_USER="admin"
export TEST_DB_MONGO_PASSWD=""
export TEST_DB_MONGO_NAME="phalcon_test"

# Redis
export TEST_RS_HOST="127.0.0.1"
export TEST_RS_PORT="6379"
export TEST_RS_DB="0"

export TEST_CACHE_DIR="/tmp"

Run tests

First you need to re-generate base classes for all suites:

vendor/bin/codecept build

Once the database is created, run the tests on a terminal:

vendor/bin/codecept run
# OR
vendor/bin/codecept run --debug # Detailed output

Execute unit test with run unit command:

vendor/bin/codecept run unit

Execute all tests from a folder:

vendor/bin/codecept run tests/unit/some/folder/

Execute single test:

vendor/bin/codecept run tests/unit/some/folder/some/test/file.php

Todo

  • Tests for foreign keys cascade in the ORM
  • Tests for many-to-many relations
  • Tests for +=, -=, *=, /=, ++, -- in Volt
  • Tests for Alc::allow('*', '*', 'index')
  • Tests for Alc::allow('*', '*', '*')
  • Tests for Alc::deny('user', '*', '*') - should deny all resources

Help

Note: Cache-related tests are slower than others tests because they use wait states (sleep command) to expire generated caches.

The file .travis.yml contains full instructions to test Phalcon Framework on Ubuntu 12+ If you cannot run the tests, please check the file .travis.yml for an in depth view on how test Phalcon. Additional information regarding our testing environment can be found by looking at the tests/_bootstrap.php file.

Please report any issue if you find out bugs or memory leaks.
Thanks!

Phalcon Framework Team
2017