Download the PHP package se7enxweb/prime without Composer

7x Prime (v2.9) — PHP 8.5 Support (Stable; Open Source)

7x Prime (v2.9) is the continuing evolution of Symfony 2.8.52, now fully compatible with PHP 8.0 through PHP 8.5. Maintained by 7x (se7enx.com) and the open-source developer community that has relied on the Symfony 2.x component library for over a decade.

Table of Contents

1. Project Notice
2. Project Status
3. Who is 7x
4. What is 7x Prime?
5. Architecture Overview
6. Technology Stack
7. Requirements
8. Quick Start
9. Main Features
10. Building Pages, Routes, and DB Results
11. Your First Bundle
12. Installation
13. Key CLI Reference
14. Issue Tracker
15. Where to Get More Help
16. How to Contribute
17. Donate & Support
18. PHPUnit 11 Test Suite
19. Copyright
20. License

1. Project Notice

Please Note: This project is not associated with the original Symfony project, SensioLabs, or Fabien Potencier beyond attribution. It is an independent, 7x + community-driven continuation of the Symfony 2.8.52 codebase, stewarded and evolved by 7x (se7enx.com) to support PHP 8.x in production. The upstream Symfony source is MIT-licensed; 7x Prime honours that licence by publishing the full source on GitHub.

2. Project Status

The Symfony 2.8.52 codebase was the final upstream release of the Symfony 2.x line. Thousands of production applications built on this component library remained in active use because the architecture — a composable component system, powerful routing, full DI container, and Twig templating — remained sound and productive long after the upstream EOL.

7x Prime (v2.9) is the first release branch that brings this codebase fully into the PHP 8.x era.

Work in the 2.9 branch focuses on:

• PHP 8.0 through PHP 8.5 full compatibility and PHPUnit test suite passing
• Security hardening: SameSite cookies, CRLF-injection protection, YAML object injection prevention
• Composer package manager integration
• Documentation and developer experience improvements

3. Who is 7x

7x is a North American web software corporation with over 24 years of experience building and maintaining PHP web applications and content platforms. Previously known as Brookins Consulting, 7x took on stewardship of the Symfony 2.8.52 codebase to ensure that the many applications built on it can continue to run on modern, supported PHP versions.

7x offers:

• Commercial PHP 8.x upgrade consulting for Symfony 2.x applications
• Hosting and infrastructure for PHP 8.x projects
• Custom development, migrations, and training
• Open-source community stewardship

4. What is 7x Prime?

7x Prime is a component library and full-stack PHP framework forked from Symfony 2.8.52. It retains the original MVC architecture, routing engine, form system, security component, console toolkit, and Twig templating while adding:

• Full PHP 8.0–8.5.6 compatibility (no deprecations, no fatal errors).
• Security hardening: SameSite cookies, CRLF-injection protection, YAML object injection prevention, hardened session defaults.
• A clean composer package (se7enxweb/prime) without obsolete polyfills.

5. Architecture Overview

Request Lifecycle

6. Technology Stack

7. Requirements

• PHP 8.0 or higher (8.5.6 recommended and tested)
• PHP extensions: mbstring, xml, intl, curl, pdo
• Composer 2.x
• A web server: Apache 2.4+ with mod_rewrite or Nginx 1.18+

Requirements Summary

8. Quick Start

9. Main Features

• MVC framework — clean separation of controllers, models, and Twig templates.
• Powerful Routing — attribute-style, YAML, XML, or PHP route definitions with parameters, requirements, defaults, and host matching.
• Form System — form types, data transformers, validation, CSRF protection built-in.
• Security Component — firewalls, access control, voters, encoders, remember-me, and session management.
• Dependency Injection Container — full-featured DI with services, parameters, compiler passes, and lazy loading.
• Console Component — build CLI commands with styled output, progress bars, and interactive helpers.
• Event Dispatcher — subscribe/listen to framework and custom events.
• Translation / i18n — XLIFF, YAML, PHP translation catalogues; pluralisation; locale negotiation.
• Validator — constraint-based validation with annotation, YAML, and XML mapping.
• HttpFoundation — OO wrappers for Request, Response, Cookie (with SameSite), Session, FileUpload, and more.
• Twig Templating — fast, secure template engine with inheritance, blocks, macros, and filters.
• Profiler / Web Debug Toolbar — built-in profiler with data collectors for requests, events, DB queries, security, logs, and more.
• PHP 8.0–8.5 full compatibility — all breaking changes addressed throughout the component library.

10. Building Pages, Routes, and DB Results

See INSTALL.md for full step-by-step instructions. Below is the three-minute version.

Define a route (YAML)

Write the controller

Render with Twig

11. Your First Bundle

A Bundle is the primary extension point in 7x Prime — a self-contained plugin that contributes routes, controllers, Twig templates, services, Doctrine entities, console commands, and more to the application.

11.1 Generating the Scaffold

Answer the interactive prompts:

This creates:

11.2 Registering the Bundle

Add the bundle to app/AppKernel.php:

Mount its routes in app/config/routing.yml:

11.3 Adding a Service

Define services in Resources/config/services.yml:

Inject it into a controller via $this->get() or constructor injection:

11.4 Customising Templates

Override a bundle template by copying it into app/Resources/:

Twig's lookup order: app/Resources/BundleName/views/ first, then src/Bundle/Resources/views/. Any file placed under app/Resources/ wins automatically — no configuration required.

Extend the global base layout using Twig block inheritance:

Publish bundle assets (CSS, JS, images) to web/bundles/:

This symlinks src/AcmeBlogBundle/Resources/public/ → web/bundles/acmeblog/, making files available at /bundles/acmeblog/css/blog.css.

11.5 Full Bundle Directory Reference

12. Installation

See INSTALL.md for the full step-by-step guide covering:

• First-time installation (6 steps)
• Apache & Nginx virtual-host configuration
• File-permission setup
• Building your first page (controller + route + Twig template)
• Database integration (PDO / Doctrine ORM)
• Composer package management
• CLI command reference
• Cache management
• Deployment checklist
• Upgrading from Symfony 2.8

13. Key CLI Reference

14. Issue Tracker

Submit bugs, feature requests, and improvements at: https://github.com/se7enxweb/prime/issues

If you discover a security issue, please report it responsibly by email to [email protected] rather than opening a public issue.

15. Where to Get More Help

Recommended Books for Newcomers

16. How to Contribute

Everyone is encouraged to contribute. To get started:

1. Fork the repository: github.com/se7enxweb/prime

2. Clone your fork and create a feature branch:

3. Make your changes following the existing code style
4. Add the (c) 2004-2026 7x <[email protected]> copyright header to every modified PHP file

5. Run the PHPUnit test suite to verify no regressions:

6. Push and open a Pull Request against the 2.9 branch
7. Participate in the code review — maintainers respond promptly

Please read CODE_OF_CONDUCT.md before submitting.

Bug reports, feature requests, and discussions are welcome via the issue tracker and GitHub Discussions.

17. Donate & Support

7x Prime is free and open-source. If it has saved you migration time, upgrade costs, or kept a production application running, please consider supporting the project:

• sponsor.se7enx.com — support subscriptions
• paypal.me/7xweb — one-time donation
• github.com/sponsors/se7enxweb — GitHub Sponsors

Every contribution funds:

• PHP compatibility testing as new PHP versions release
• Security patching and vulnerability triage
• Documentation and developer experience improvements
• Community infrastructure

18. PHPUnit 11 Test Suite

7x Prime ships a complete test suite covering every component, bridge, and bundle in the framework, verified to pass with PHPUnit 11.5 on PHP 8.5.6 — zero errors, zero failures, zero warnings, and zero framework-attributed deprecations.

Test Suite Status

Requirements

PHPUnit 11 requires PHP 8.1 or higher and is not bundled in vendor/. Install it globally (recommended) or as a project dev dependency:

Running the Full Suite

Running a Subset

Displaying Deprecations, Warnings, and Notices

PHPUnit 11 — Key Differences from PHPUnit 4–9

PHPUnit 11 uses PHP 8 native attributes in place of docblock annotations. Both styles are accepted in 7x Prime's own test files, but attributes are preferred in new code:

Common attribute mapping:

Writing Tests for 7x Prime Bundles

Place test classes in src/YourBundle/Tests/ following PHPUnit conventions. Use PHPUnit\Framework\TestCase for unit tests and Symfony\Bundle\FrameworkBundle\Test\WebTestCase for full HTTP functional tests:

Run your bundle's tests:

Code Coverage

Extending the Test Suite

To add tests for framework code, create a test file in the corresponding component's Tests/ directory and follow the existing naming and structure conventions:

PHPUnit discovers tests automatically via the phpunit.xml.dist <testsuites> definition. No registration is required — place your *Test.php file in the right directory and run the suite.

See INSTALL.md — Section 15 for the full PHPUnit 11 reference guide including coverage, custom base classes, Symfony-specific test helpers, and CI integration patterns.

19. Copyright

20. License

7x Prime is released under the MIT License. See LICENSE for the full licence text.

The upstream Symfony source is also MIT-licensed. 7x Prime honours that licence by publishing the full source on GitHub.