Weave Code
Sulu Laravel Package
sulu/sulu
Sulu is a highly extensible open-source PHP content management system built on Symfony, designed for multi-lingual, multi-portal websites with an intuitive, extensible admin interface. This package is the core framework behind every Sulu project.
Project template for starting your new project based on the Sulu content management system
Frequently asked questions about Sulu
- Is sulu/sulu compatible with Laravel?
- No. Sulu is a Symfony-based content management system core, not a Laravel package. Laravel developers should evaluate it as a separate Symfony CMS rather than expecting Laravel service providers, facades, or Laravel version support.
- What PHP and Symfony versions does sulu/sulu require?
- Sulu requires PHP 8.2 or newer and Symfony 6.4 through 7.4. If your application is outside that range, plan for dependency upgrades and migration work before integrating Sulu. Check your existing Symfony and Doctrine versions early.
- How do I install sulu/sulu for a new project?
- For a new Sulu project, start with the sulu/skeleton template rather than installing only the core package. The sulu/sulu package is the core framework dependency used by Sulu projects, so the skeleton provides the application structure and configuration.
- Does Sulu support multi-lingual and multi-portal websites?
- Yes. Sulu is designed for multi-lingual and multi-portal websites with structured content management, workspaces, versioning, and preview modes. This makes it suitable for content-heavy sites that need multiple languages or portals from one CMS.
- Can I use Sulu as a headless CMS with React or Vue?
- Yes. Sulu supports API-first delivery through Symfony's HTTP layer, including REST and GraphQL approaches, so frontends can be built with React, Vue, or other technologies. The admin interface itself uses Vue.js, but content delivery can remain decoupled from Twig rendering.
- What breaking changes should I expect when upgrading Sulu 2.x to 3.x?
- Sulu 3.x introduces breaking changes such as Doctrine 3 updates, route entity changes, and PHPStan fixes. Follow the official upgrade guide and test migration scripts, including sulu:build and doctrine:migrations, before upgrading production systems.
- What changed in Sulu 3.0.10 that affects production deployments?
- Sulu 3.0.10 includes a security fix for media permission checks on preview and format endpoints, stronger add and live permission enforcement, and improved two-factor authentication setup flows. It also changes search index behavior so indexes are created on build only if missing. Patch promptly, review role configurations, and verify search indexes in deployment pipelines.
- How does Sulu handle permissions and two-factor authentication?
- Sulu includes built-in RBAC and permission systems through its AdminBundle. In 3.0.10, add and live permissions are required for pages, snippets, and articles, and copying those entities requires add permission. Two-factor routes are registered only with a setup method, and forced setup is guided, so test admin and integration flows carefully.
- How do I extend Sulu with custom content types or workflows?
- Sulu is designed for customization through bundles, so you can add custom content types, workflows, and integrations without forking the core. Use the sulu/skeleton template and official Sulu bundles as the starting point, and expect to need Symfony and Sulu admin knowledge.
- What should I test before deploying Sulu 3.0.10?
- Test permission matrices for pages, snippets, articles, and copying, plus two-factor authentication enrollment and admin login flows. Verify search index existence, CKEditor configuration for text part language support, and migration checks for references and teaser fields. Custom admin test suites may also need updates for the React Testing Library migration.
Weaver
How can I help you explore Laravel packages today?