mikejw/empathy

Empathy PHP Framework

v4.2.3 2025-10-31 18:11 UTC

Requires

• php: >=8.4.0
• mikejw/elibs: ^2
• monolog/monolog: ^2.5.0
• mustangostang/spyc: 0.6.3
• php-di/php-di: ^7.0
• wp-cli/php-cli-tools: dev-master

Requires (Dev)

• mockery/mockery: ^1.3.0
• nelmio/alice: dev-2.x-dev
• phpunit/phpunit: ^8
• squizlabs/php_codesniffer: ^3.7.2

MIT

• Michael J. Whiting

• framework
• mvc

README

 

empathy.sh

Welcome to the Empathy (micro MVC) PHP Framework project. The project has existed since 2008 and is geared towards allowing anyone to create PHP web applications, with following properties:

• Strict MVC pattern
• Modular compatible libraries
• Lightweight
• Fast
• Extensible

Documentation

See getting-started.md.

Licence

Empathy and officially released extension libraries are now distributed under an MIT license. See LICENSE.

Testing the code itself

If you want to run tests from a version of Empathy that has been checked out in base-docker connect to the app container first, change to the empathy vendor directory and run composer install:

docker exec -it -u www-data app /bin/bash
cd ./vendor/mikejw/empathy/
php ../../../composer.phar install --prefer-source

Within the 'Empathy Architype Application' config file (/eaa/config.yml), set: doc_root to the full location of the eaa directory, (which is used for dummy configuration) e.g:

---
doc_root: /var/www/project/vendor/mikejw/empathy/eaa

For the elibs plugin configuration (within /eaa/config.yml), set testing mode to 1. (This makes sure that the elibs repo containing Smarty can be found.) i.e:

plugins:
  -
    name: ELibs
    version: 1.0
    config: '{ "testing": 1 }'

Change to the t directory from the root of the empathy repo and run phpunit:

cd /var/www/project/vendor/mikejw/empathy/t
php ../vendor/bin/phpunit .