v4.0.0: Merge pull request #14 from gaambo/v4

Version 4

Author: gaambo

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{json,yml,yaml,md}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.php]
+max_line_length = 120 

.gitattributes

@@ -0,0 +1,9 @@
+/.editorconfig export-ignore
+/.gitattributes export-ignore
+/.github/ export-ignore
+/.gitignore export-ignore
+/docs/ export-ignore
+/phpcs.xml export-ignore
+/phpstan.neon export-ignore
+/phpunit.xml export-ignore
+/tests/ export-ignore 

.github/workflows/code-quality.yml

@@ -0,0 +1,55 @@
+name: Code Quality
+
+on:
+  push:
+  pull_request:
+  # Allow manually triggering the workflow.
+  workflow_dispatch:
+
+jobs:
+  code-quality:
+    name: Run Code Quality Checks
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    strategy:
+      matrix:
+        php: ['8.1', '8.2', '8.3', '8.4']
+      fail-fast: false
+
+    steps:
+      # Checkout the repository
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      # Setup PHP with Composer and cs2pr
+      - name: Setup PHP and tools
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          tools: composer:v2, cs2pr
+
+      # Validate composer.json
+      - name: Validate composer.json
+        run: composer validate --strict
+
+      # Install dependencies with caching
+      - name: Install Composer dependencies
+        uses: ramsey/composer-install@v3
+        with:
+          composer-options: '--prefer-dist --no-progress'
+
+      # Run PHP syntax linting
+      - name: Run PHP syntax linting
+        run: composer run-script lint
+
+      # Run PHP CodeSniffer with GitHub annotations
+      - name: Run PHP CodeSniffer
+        run: |
+          composer run-script phpcs -- --standard=phpcs.xml --report-checkstyle=./phpcs-report.xml
+          cs2pr ./phpcs-report.xml
+
+      # Run PHPStan with GitHub annotations
+      - name: Run PHPStan
+        run: |
+          composer run-script phpstan -- --error-format=checkstyle > phpstan-report.xml
+          cs2pr ./phpstan-report.xml

.github/workflows/composer-diff.yml

@@ -0,0 +1,32 @@
+name: Composer Lock Diff
+
+on:
+  pull_request:
+    paths:
+      - 'composer.json'
+      - 'composer.lock'
+
+jobs:
+  composer-diff:
+    name: Composer Lock Diff
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      # Checkout the repository
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      # Generate composer.lock diff
+      - name: Generate composer.lock diff
+        id: composer-diff
+        uses: IonBazan/composer-diff-action@v1
+
+      # Post diff as sticky comment
+      - name: Post diff as sticky comment
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          message: |
+            ## Composer Package Changes
+            ${{ steps.composer-diff.outputs.diff }} 

.github/workflows/tests.yml

@@ -1,4 +1,4 @@
-name: Pull Request Tests
+name: Tests
 
 on:
   pull_request:
@@ -7,19 +7,43 @@ on:
 
 jobs:
   tests:
-    name: Run PHPUnit Tests
     runs-on: ubuntu-latest
     timeout-minutes: 10
     strategy:
       matrix:
-        php: ['8.1', '8.2', '8.3', '8.4']
+        php: [ '8.1', '8.2', '8.3', '8.4' ]
         # TODO: Add 8.0 when released.
-        deployer: ['^7.3', '^7.4', '^7.5']
-        include:
-          - name: Deployer ${{ matrix.deployer }} on PHP ${{ matrix.php }}
+        deployer: [ '7.3', '7.4', '7.5' ]
       fail-fast: false
+    name: Tests for Deployer ${{ matrix.deployer }} on PHP ${{ matrix.php }}
 
     steps:
       # Checkout the repository
       - name: Checkout repository
         uses: actions/checkout@v4
+
+      # Setup PHP with Composer
+      - name: Setup PHP and tools
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          tools: composer:v2
+
+      # Install dependencies with caching
+      - name: Install Composer dependencies
+        uses: ramsey/composer-install@v3
+        with:
+          composer-options: '--prefer-dist --no-progress'
+
+      # Install specific Deployer version
+      - name: Install Deployer version
+        # Install latest patch of the specified version.
+        run: composer require --no-update deployer/deployer:"${{ matrix.deployer }}.*"
+
+      # Run PHPStan so we check compatibility with the specified Deployer version.
+      - name: Run PHPStan
+        run: composer run-script phpstan
+
+      # Run PHPUnit tests
+      - name: Run PHPUnit tests
+        run: composer run-script tests

.gitignore

@@ -1,2 +1,8 @@
-/vendor/
-/test
+/vendor
+/.cursor
+/.junie
+/.idea
+.DS_STORE
+.phpunit.cache
+.phpunit.result.cache
+tests/coverage

CHANGELOG.md

@@ -1,9 +1,56 @@
 # Changelog
 
+## v4.0.0 - 2025-03-20
+
+v4 is a major refactor focusing on simpler, rsync-based deployments with better developer experience.
+
+_Info:_ This release does not yet officially support Deployer v8, since it's not released yet.
+
+### Breaking Changes
+
+- **Architecture**: Now uses `current_path` as primary deployment target instead of symlinked `release_path`. Atomic
+  releases via symlinks are still possible but no longer the default.
+- **PSR-4 structure**: Internal code reorganized with PSR-4 autoloading. Task files moved from `src/tasks/` to `tasks/`.
+- **Removed `advanced` recipe**: Use `simple` or `bedrock` recipes instead.
+- **Removed `:sync` tasks**: Use explicit `:push` and `:pull` tasks instead.
+
+### Added
+
+- **Packages system**: Unified way to manage custom themes, plugins, and mu-plugins with individual build scripts and
+  vendor configs.
+- Older `themes`/`plugins`/`mu-plugins` are still available for backwards compatibility, but will be removed in a future
+  release.
+- **Multisite support**: Set `wp/multisite` flag for proper URL replacements during database sync.
+- **Language tasks**: New tasks for syncing language files (`languages:push`, `languages:pull`, `languages:backup:*`).
+- **Localhost context**: Proper context handling for local operations with consistent path resolution.
+- **New recipes**: `recipes/simple.php` for rsync deployments, `recipes/bedrock.php` for Bedrock projects.
+- **Comprehensive tests**: Full integration and functional test suite.
+
+### Changed
+
+- Improved bin detection and auto-installation for `composer` and `wp-cli`.
+- Enhanced database task logic for URL/path replacements.
+- Better sudo prefix handling in binary execution.
+
+### Fixed
+
+- Database pulling and local importing.
+- Recipe include paths when installed via composer.
+- Path resolution in localhost operations.
+
+### Upgrading from v3.x
+
+1. **Set `current_path`**: Define where your WordPress root lives on each host (including localhost).
+2. **Migrate to packages**: Move theme/plugin build config to the new `packages` configuration.
+3. **Update recipe**: Switch from old recipes to `recipes/simple.php` or `recipes/bedrock.php`.
+4. **Check examples**: Review `examples/simple/` or `examples/bedrock/` for updated patterns.
+5. **Replace `:sync` tasks**: Update custom tasks using `:sync` to use `:push` or `:pull`.
+
 ## v3.1.0
 
 - Added a `deploy:build_assets` step into the default deploy task to build theme assets on local.
-This allows for easier overwriting this task (eg to build custom plugin assets) and fixes running duplicates on some configurations.
+  This allows for easier overwriting this task (eg to build custom plugin assets) and fixes running duplicates on some
+  configurations.
 
 ## v3.0.0
 
@@ -17,25 +64,33 @@ This allows for easier overwriting this task (eg to build custom plugin assets)
   - Removed `document_root` - use `release_or_current_path` instead
 - New/changed task names:
   - `push_code` now is called `update_code` again for parity with PHPDeployer.
- 
+
 **Upgrading:**
-  - If you haven't upgraded to v2.0.0 yet, it's best to upgrade to 3.0.0 directly
-  - Have a look at the example files. Your deploy.php will get much smaller and require less configuration. 
-  - Also the new version is more smiliar to PHPDeployers default common recipe.
+
+- If you haven't upgraded to v2.0.0 yet, it's best to upgrade to 3.0.0 directly
+- Have a look at the example files. Your deploy.php will get much smaller and require less configuration.
+- Also the new version is more smiliar to PHPDeployers default common recipe.
 
 ## v2.0.0
 
 - Updated from Deployer 6.x to 7.x
   See [docs](https://deployer.org/docs/7.x/UPGRADE#upgrade-from-6x-to-7x) for more information.
   Most notable changes:
-    - New format for yml-files which can now also include configuration.
-    - The `local` is not available any more. Instead `once` and `runLocally` should be used. For theme assets the example uses a function callback and the `on` helper to optionally run those build tasks on the local host.
-    - When deploying you can't select a host by name or stage anymore. Instead you have to use labels (eg a `stage` label). If you've used `dep deploy production` you now have to use `dep deploy stage=production` and set the stage label in your yml file.
+  - New format for yml-files which can now also include configuration.
+  - The `local` is not available any more. Instead `once` and `runLocally` should be used. For theme assets the example
+    uses a function callback and the `on` helper to optionally run those build tasks on the local host.
+  - When deploying you can't select a host by name or stage anymore. Instead you have to use labels (eg a `stage`
+    label). If you've used `dep deploy production` you now have to use `dep deploy stage=production` and set the stage
+    label in your yml file.
 - Switched to a single base recipe which can be included and built upon. See `examples/deploy.php`.
-- The new recipe and examples uses yml-files for project-specific configuration so the `deploy.php` is a dropin file and has no configuration in it.
+- The new recipe and examples uses yml-files for project-specific configuration so the `deploy.php` is a dropin file and
+  has no configuration in it.
 - PHP 8 compatibility.
 - Fixes issues with rsync flags/options and `'`.
 
 **Upgrading:**
-If you've used the default recipe it's probably easiest to copy the new example `deploy.php` and update your yml-file with project-specific configuration. If you have added any other tasks/features to your `deploy.php` make sure you upgrade them too.
-If you've used most of the core functions of this library or just the examples, the upgrade should only take a few minutes.
+If you've used the default recipe it's probably easiest to copy the new example `deploy.php` and update your yml-file
+with project-specific configuration. If you have added any other tasks/features to your `deploy.php` make sure you
+upgrade them too.
+If you've used most of the core functions of this library or just the examples, the upgrade should only take a few
+minutes.