Ci Scripts Laravel Package

Product Decisions This Supports

• Enhanced Headless Regression Testing: Strengthens the use case for Ibexa Headless (API-first) architectures with dedicated regression tests (IBX-5798), enabling teams to validate headless implementations more robustly.
• PHP 8.2 and Node.js 18+ Compatibility: Further solidifies the roadmap to modernize the tech stack by adding explicit PHP 8.2 support (via custom error handlers) and ensuring Node.js 18 compatibility (IBX-4516), reducing long-term technical debt.
• Improved CI/CD Flexibility: Addresses build vs. buy trade-offs by removing hardcoded dependencies (e.g., productVersion, Behat version pinning) and introducing CLI-driven configuration, making the package more adaptable to custom workflows.
• Visual Testing Integration: Expands testing capabilities with visual regression testing, aligning with a feature to catch UI inconsistencies across environments (development, staging, production).
• Git and Dependency Optimization: Reduces CI/CD friction by marking /var/www as safe for Git (avoiding permission issues) and optimizing dependency installation order, improving scalability for large Laravel/PHP projects.
• Parallel Testing Refinements: Enhances the feature for parallel regression builds with better dependency management (e.g., delayed dependency installation), improving efficiency for multi-environment testing.

When to Consider This Package

• Adopt if:

  • Your team uses Ibexa DXP (v3.3+, v4.5+, v4.6+) and needs PHP 8.2+ and Node.js 18 support in CI/CD pipelines.
  • You require headless regression testing (API-first validation) or visual testing for Ibexa projects.
  • Your workflow involves pull requests from forks (fixed Composer data handling) or multi-environment parity (Git-safe directories, dependency isolation).
  • You want to avoid hardcoded configurations (e.g., Behat versions, product versions) and prefer CLI-driven customization.
  • Your team lacks DevOps resources but needs pre-configured, Ibexa-specific CI scripts with active maintenance (recent releases, new contributors).

• Look elsewhere if:

  • You are not using Ibexa DXP or require non-Ibexa-specific CI tools (e.g., generic Laravel testing).
  • Your project needs PHP <8.1 or Node.js <18 (package now enforces these versions).
  • You prioritize open-source-only licenses (dual Ibexa BUL/GPLv2 remains).
  • Your CI relies on custom Behat or Docker setups that conflict with the package’s assumptions (e.g., hardcoded paths).
  • You need highly dynamic or non-Ibexa dependency management (e.g., Jenkins plugins with extensive customization).

How to Pitch It (Stakeholders)

For Executives: *"The latest release (v0.2.4) of ibexa/ci-scripts significantly enhances our ability to future-proof and scale Ibexa DXP projects. Key improvements include:

• PHP 8.2 and Node.js 18 support, ensuring compatibility with modern infrastructure and reducing upgrade costs.
• Headless regression testing (IBX-5798) and visual testing, critical for validating API-first and UI consistency across environments.
• Flexible CI configurations via CLI-driven parameters, reducing lock-in to hardcoded dependencies while maintaining Ibexa-specific optimizations.
• Git and dependency optimizations that cut CI/CD friction, improving developer productivity. This aligns with our roadmap to modernize the stack and standardize testing—delivering faster, more reliable pipelines with minimal maintenance overhead. The dual license remains non-issue for DXP users, and the package’s recent activity (new contributors, targeted fixes) signals strong Ibexa backing."*

For Engineering/DevOps: *"v0.2.4 introduces game-changing improvements for Ibexa CI/CD:

• PHP 8.2 readiness: Custom error handlers prevent runtime issues, while Node.js 18 is now the default.
• Headless testing: Dedicated regression tests (IBX-5798) validate API endpoints, critical for migration projects.
• Visual testing: Catches UI regressions early, reducing manual QA effort.
• Flexibility gains:
  • Removed hardcoded productVersion and Behat pinning (PR #61, #64).
  • CLI-driven edition passing (PR #71) for dynamic workflows.
  • Optimized dependency installation order (PR #76, #81) to avoid conflicts.
• Git safety: /var/www is now marked safe (PR #74), preventing permission errors in PR builds. Recommendation: Adopt for Ibexa DXP projects to leverage these out-of-the-box improvements while avoiding reinventing CI wheel. The package’s focus on modularity (e.g., separated search indexing) also makes it easier to extend for custom needs."*