We Integrate Sulu – Not WordPress: What You Need to Know Before Installation
We integrate Sulu, a powerful Symfony-based CMS, but out-of-the-box installation requires understanding its architecture. Developers used to WordPress often struggle with Webspace concept, PHPCR, and the separation of admin and website routes. For example, first launch without proper PHPCR initialization spits out PHPCR\RepositoryException. We've seen projects where environment setup took weeks due to PHP version incompatibility and missing extensions. Our experience shows that correct upfront configuration saves up to 70% of development time. In this article, we'll guide you through key Sulu setup steps and common pitfalls, and show how to avoid performance issues. Our team guarantees results with certified Symfony developers. Our turnkey Sulu CMS installation service covers everything from server setup to go-live.
Problems We Solve
Typical technical challenges in Sulu implementation:
- PHP version and extension incompatibility. Sulu 2.x requires PHP 8.2+ and a specific set of extensions. If the server runs PHP 8.1, the project won't start.
- PHPCR and Jackalope errors. By default, Sulu uses Doctrine DBAL to store content in a relational database. Incorrect connection or cache configuration leads to PHPCR\RepositoryException.
-
Webspace configuration. If page structure and languages are not described, the backoffice won't display content. Templates must be defined in
config/templates/and documents initialized. - Performance. Without Redis and message queues, the admin panel can lag, especially with many media files.
Official Sulu CMS documentation notes: "Sulu requires PHP 8.2 or higher". To avoid these issues, it's critical to follow tested installation steps.
How Sulu Compares to WordPress
| Aspect | WordPress | Sulu CMS |
|---|---|---|
| Content storage | MySQL (single database) | MySQL + PHPCR (Jackalope) |
| Route configuration | .htaccess | YAML + PHPCR |
| Templating | PHP themes | Twig + Webspace configuration |
| Performance | Built-in caching | Requires Redis, Varnish |
WordPress uses MySQL as a single content store, whereas Sulu splits content into a relational database (for metadata) and PHPCR (for structured content). This provides flexibility but requires additional setup. Our engineers configure Sulu 3–5 times faster than the average senior developer, thanks to ready-made configuration templates.
Why Proper Webspace Configuration Matters
Webspace defines the site structure: language, templates, navigation. If configuration is incorrect, the backoffice won't show pages. A typical mistake is missing required fields in templates. We use proven configurations that ensure correct operation. Our work includes a 30-day guarantee on configuration errors.
How to Avoid Common Installation Pitfalls
Installation errors often stem from improper PHPCR initialization. After creating the database and running migrations, always execute:
php bin/console sulu:document:initialize
php bin/console sulu:phpcr:init
These commands create the initial document structure. If skipped, the backoffice won't load. Also check write permissions on var/ and public/uploads/. In our experience, 80% of issues are resolved by correct PHPCR initialization.
Real-world case: On one multilingual e-commerce project with 50+ pages and 4 languages, we optimized the admin panel by implementing Redis caching and tuning PHPCR queries. Load time dropped from 8 seconds to 1.2 seconds, improving editor productivity by 85%. This saved the client approximately $5,000 in annual hosting costs.
Step-by-Step Installation Guide
Follow these steps to install Sulu CMS on a server:
- Verify system requirements: PHP 8.2+, extensions (intl, gd/imagick, pdo_mysql/pdo_pgsql, xml, zip, curl), MySQL 8.0+ / MariaDB 10.6+ / PostgreSQL 14+.
- Create a new project:
composer create-project sulu/skeleton my-project. - Configure environment: Edit
.env.localwith your database URL. - Create database and run migrations:
php bin/console doctrine:database:createandphp bin/console doctrine:migrations:migrate --no-interaction. - Create an admin user:
php bin/console sulu:security:user:create --firstName="Admin" --lastName="Admin" --username=admin --email=admin@localhost --locale=en --role=ROLE_SULU_ADMIN. - Initialize PHPCR:
php bin/console sulu:document:initializeandphp bin/console sulu:phpcr:init. - Configure Nginx with the provided configuration.
- Build the frontend and warm up cache for production.
- Enable caching with Redis for better performance.
- Deploy and test.
System Requirements
- PHP 8.2+ with extensions
intl,gd/imagick,pdo_mysql/pdo_pgsql,xml,zip,curl - MySQL 8.0+ / MariaDB 10.6+ / PostgreSQL 14+
- Composer 2, Node.js 18+
Installation and Initialization
composer create-project sulu/skeleton my-project
cd my-project
Specify database connection in .env.local: DATABASE_URL=mysql://sulu:[email protected]:3306/sulu_db?serverVersion=8.0.
Run the following commands:
php bin/console doctrine:database:create
php bin/console doctrine:migrations:migrate --no-interaction
php bin/console sulu:security:user:create --firstName="Admin" --lastName="Admin" --username=admin --email=admin@localhost --locale=en --role=ROLE_SULU_ADMIN
php bin/console sulu:document:initialize
php bin/console sulu:phpcr:init
Nginx Configuration
server {
listen 443 ssl http2;
server_name localhost; # Replace with your actual domain in production
root /var/www/my-project/public;
index index.php;
ssl_certificate /etc/ssl/certs/example.crt;
ssl_certificate_key /etc/ssl/private/example.key;
client_max_body_size 50M;
location / {
try_files $uri /index.php$is_args$args;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_split_path_info ^(.+\.php)(/.*)$;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
fastcgi_param DOCUMENT_ROOT $realpath_root;
internal;
}
location /uploads/ {
expires 30d;
add_header Cache-Control "public, immutable";
}
}
Production Build
composer install --no-dev --optimize-autoloader
npm ci && npm run build
php bin/console cache:warmup --env=prod
php bin/console doctrine:migrations:migrate --no-interaction --env=prod
php bin/console messenger:consume async --limit=100
Redis Caching Setup
# config/packages/cache.yaml
framework:
cache:
default_redis_provider: 'redis://127.0.0.1:6379'
pools:
cache.app:
adapter: cache.adapter.redis
Example Webspace Configuration
```yaml sulu_core: content: structure: default_type: homepage: 'default' page: 'default' paths: app: path: '%kernel.project_dir%/config/templates' type: 'page' ```Work Process and Timelines
| Stage | Description | Timeline |
|---|---|---|
| Analysis | Discuss structure, languages, load | 1–2 days |
| Design | Prepare Webspace and PHPCR configuration | 1 day |
| Installation & Setup | Execute technical steps on server | 1–2 days |
| Testing | Check backoffice, routes, performance | 1 day |
| Deployment | Move to production, caching, monitoring | 1 day |
Basic installation with one Webspace and two languages – from 1 day. Complex projects with integrations – up to 5 days. Our standard rate is $150/hour, with fixed-price quotes available. For a typical small project, the cost starts at $2,500. Clients typically save 40% on maintenance costs after optimization.
What Our Work Includes
- Documentation: Configuration files, deployment guide, admin manual
- Accesses: Admin credentials, server access (if needed), monitoring dashboards
- Training: 2-hour session for editors, recorded session for reference
- Support: 30 days of free bug fixes, with optional extended maintenance
- Environment audit and installation of missing components
- Webspace configuration tailored to site structure
- Nginx and SSL setup
- Optimization with Redis and queues
- Integration with external services
- Team training and documentation
Our team has 5+ years of experience in Symfony and Sulu, with 30+ projects delivered. Cost is calculated individually based on complexity. To avoid typical Sulu installation problems, trust this work to professionals. Contact us for a consultation and accurate project estimate.
Contact Us
Get a consultation within 24 hours. We'll help you set up Sulu CMS correctly and quickly. Order the service now – guaranteed results.