/candle

PHP Tooling CI test

Primary LanguageShell

Candle

Built With Plugin Machine

Installation

  • Git clone:
    • git clone git@github.com:shelob9/candle.git
  • Install javascript dependencies
    • yarn
  • Install php dependencies
    • composer install

Working With PHP

Autoloader

PHP classes should be located in the "php" directory and follow the PSR-4 standard.

The root namespace is Candles.

Tests

  • Run unit tests
    • composer test:unit
  • Run WordPress tests
    • composer test:wordpress
    • See local development instructions for how to run with Docker.
  • Run unit tests and WordPress tests
    • composer test

Linter

PHPCS is installed for linting and automatic code fixing.

  • Run linter and autofix
    • composer fixes
  • Run linter to identify issues.
    • compose sniffs

Local Development Environment

A docker-compose-based local development environment is provided.

  • Start server
    • docker-compose up -d
  • Acess Site
  • WP CLI
    • Run any WP CLI command in container:
      • docker-compose run wpcli wp ...
    • Setup site with WP CLI
      • docker-compose run wpcli wp core install --url=http://localhost:6048 --title="Candle" --admin_user=admin0 --admin_email=something@example.com
      • docker-compose run wpcli wp user create admin admin@example.com --role=administrator --user_pass=pass

There is a special phpunit container for running WordPress tests, with WordPress and MySQL configured.

  • Enter container
    • docker-compose run phpunit
  • Composer install
    • composer install
  • Test
    • composer test:wordpress