🚀 PHPix - Modern PHP Workflow Toolkit

✨ Features

🔧 Quick Start

# Clone the repository
git clone https://github.com/nnosal/phpix.git
cd phpix
# Run automated installation
chmod +x install.sh
./install.sh
# Verify installations
php -v # PHP 8.4.x
composer -V # Composer 2.x
wp --version # WP-CLI 2.12.0
dep --version # Deployer 7.5.x
psysh --version # PsySH 0.x

📦 What Gets Installed

Core Tools

🎯 Usage Examples

PsySH Interactive Development

# WordPress user inspection
psysh <<EOF
require 'vendor/autoload.php';
\$user = new WP_User(1);
dump(\$user->to_array());
EOF
# Database query
psysh --no-interaction '$pdo=new PDO("mysql:host=localhost;dbname=test","user","pass");$stmt=$pdo->query("SELECT COUNT(*) as count FROM users");print_r($stmt->fetch());'
# Email testing
psysh --no-interaction '$to="test@example.com";$subject="Test PsySH";$msg="Email test!";mail($to,$subject,$msg,"From: noreply@domain.com")&&echo"✓ Envoi OK";'

CPX Package Runner

# Laravel scaffolding
cpx laravel new MonSuperProjet && cd $_
# PHP CS Fixer
cpx php-cs-fixer fix ./src
# Psalm static analysis
cpx psalm

Deployer Automation

# Deploy to staging
dep deploy staging
# Deploy to production
dep deploy production
# Rollback if needed
dep rollback production
# Run custom tasks
dep cache:clear production

Mise Task Runner

# List available tasks
mise tasks
# Run custom tasks (define in mise.toml)
mise run deploy:staging
mise run test

📁 Project Structure

phpix/
├── README.md # This file
├── meta.json # Project metadata & environments
├── mise.toml # Task runner configuration
├── install.sh # Automated installation script
├── deploy.php # Deployer recipe
├── composer.json # PHP dependencies
├── src/ # Source code
│ └── example.php # Demo PHP file
├── tests/ # Test suite
│ └── ExampleTest.php
└── .github/
 └── workflows/
 └── ci.yml # GitHub Actions CI/CD

🌍 Environment Configuration

{
 "env": {
 "production": {
 "host": "prod.example.com",
 "user": "deploy",
 "deploy_path": "/var/www/production"
 },
 "staging": {
 "host": "staging.example.com",
 "user": "deploy",
 "deploy_path": "/var/www/staging"
 },
 "develop": {
 "host": "localhost",
 "deploy_path": "./build"
 }
 }
}

🔄 CI/CD Pipeline

📝 Requirements

🛠️ Customization

Adding Custom Deployer Tasks

task('custom:task', function () {
 run('echo "Running custom task"');
});
after('deploy:symlink', 'custom:task');

Adding Mise Tasks

[tasks."deploy:all"]
run = "dep deploy --all"
description = "Deploy to all environments"
[tasks.test]
run = "vendor/bin/phpunit"
description = "Run test suite"

📚 Documentation

🏢 About

📄 License