mirror of
https://github.com/opensourcepos/opensourcepos.git
synced 2026-11-05 05:53:18 -05:00
- Extend composer.json and composer.lock PHP requirement to include PHP 8.5 - Add PHP 8.5 to test matrix in phpunit.yml and main.yml workflows - Modernize php-linter.yml to use setup-php@v2 with parallel matrix for PHP 8.2–8.5 - Propagate PHP 8.2 lint failures via shell loop in find -exec + while retaining batching for 8.3–8.5 - Add permissions: contents: read and cancel-in-progress concurrency to php-linter.yml - Remove obsolete Node.js and npm install steps from phpunit.yml - Update phpunit.yml runner to ubuntu-latest and composer cache action to v4 - Address PHP 8.5 deprecations and syntax: - Replace deprecated switch-case semicolon with standard colon in app/Config/Database.php - Replace non-standard (double) cast with (float) in app/Libraries/Token_lib.php - Remove obsolete curl_close() calls in app/Config/Validation/OSPOSRules.php and app/Libraries/Mailchimp_lib.php - Update INSTALL.md, workflows README, and bug report issue template to include PHP 8.5
GitHub Actions
This document describes the CI/CD workflows for OSPOS.
Build and Release Workflow (.github/workflows/build-release.yml)
Build Process
- Setup PHP 8.2 with required extensions
- Setup Node.js 22
- Install composer dependencies
- Install npm dependencies
- Build frontend assets with Gulp
Docker Images
- Build and push
opensourceposDocker image for multiple architectures (linux/amd64, linux/arm64) - On
master: taggedmasterand<sha> - On other branches: tagged
<branch>-<sha> - On a semver tag (e.g.
3.4.2): tagged<version>andlatest - The version number is never stamped onto
master/branch builds — it only appears on tag releases - Pushed to Docker Hub
Releases
- Create distribution archives (tar.gz, zip)
- Create/update GitHub "unstable" release on master branch only
Required Secrets
To use this workflow, you need to add the following secrets to your repository:
- DOCKER_USERNAME - Docker Hub username for pushing images
- DOCKER_PASSWORD - Docker Hub password/token for pushing images
How to add secrets
- Go to your repository on GitHub
- Click Settings → Secrets and variables → Actions
- Click New repository secret
- Add
DOCKER_USERNAMEandDOCKER_PASSWORD
The GITHUB_TOKEN is automatically provided by GitHub Actions.
Workflow Triggers
- Push to master - Runs build, Docker push (
master+<sha>tags), and creates/updates theunstablerelease - Push to other branches - Runs build and Docker push (
<branch>-<sha>tag) - Push a semver tag (e.g.
3.4.2) - Runs build and Docker push (<version>+latesttags) - Pull requests - Runs build only (PHPUnit tests run in parallel via phpunit.yml); no Docker push
Existing Workflows
This repository also has these workflows:
.github/workflows/main.yml- PHP linting with PHP-CS-Fixer.github/workflows/phpunit.yml- PHPUnit tests (runs on all PHP versions 8.2-8.5).github/workflows/php-linter.yml- PHP linting
Testing
PHPUnit tests are run separately via .github/workflows/phpunit.yml on every push and pull request, testing against PHP 8.2, 8.3, 8.4, and 8.5.
To test the build workflow:
- Add the required secrets
- Push to master or create a PR
- Monitor the Actions tab in GitHub