How to Install Symfony 5 with Nginx on Ubuntu Linux

Setting up Symfony 5 with Nginx on an Ubuntu Linux server is a powerful way to develop and deploy modern PHP applications. Symfony offers a robust framework for building scalable and maintainable web apps, while Nginx provides high performance and efficient handling of web traffic. This guide walks you through each step to get your Symfony 5 project up and running smoothly on Ubuntu, ensuring you have a solid foundation for development or production deployment. Before starting, ensure you have a fresh Ubuntu server (Ubuntu 20.04 or later) with root or sudo privileges. Additionally, a basic understanding of Linux command line, PHP, and web server concepts will make the process smoother.

What You’ll Need

Ubuntu Linux server (20.04 or newer)
Root or sudo access to the server
Domain name pointed to your server’s IP (optional but recommended)
Basic knowledge of Linux command line
Internet connection for downloading packages
SSL certificate (optional but recommended for production)

Step-by-Step

Update Your System: Begin by updating your package list and upgrading existing packages to ensure your system is current. Run:

sudo apt update && sudo apt upgrade -y

Install Necessary Dependencies: Install PHP, Composer, Nginx, and other required packages. Run:

sudo apt install php php-cli php-common php-fpm php-mbstring php-xml php-intl php-zip php-pdo php-mysql php-bcmath php-tokenizer php-curl unzip curl git nginx -y

Install Composer: Composer is PHP’s dependency manager. Download and install it with:

curl -sS https://getcomposer.org/installer | php sudo mv composer.phar /usr/local/bin/composer

Create Your Symfony Project: Navigate to your web directory (e.g., /var/www) and create a new Symfony project:

cd /var/www sudo composer create-project symfony/skeleton my_project

Replace ‘my_project’ with your preferred project directory name.

Configure PHP-FPM: Ensure PHP-FPM is running and correctly configured. Restart PHP-FPM service:

sudo systemctl restart php*-fpm

Set Proper Permissions: Adjust ownership to allow Nginx to serve your project:

sudo chown -R www-data:www-data /var/www/my_project

Configure Nginx: Create a new Nginx server block for your Symfony project. Use:

sudo nano /etc/nginx/sites-available/my_project

and add the following configuration, replacing ‘yourdomain.com’ with your domain or server IP:

server { listen 80; server_name yourdomain.com; root /var/www/my_project/public; index index.php; location / { try_files $uri /index.php$is_args$args; } location ~ \.php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } location ~ \.htaccess { deny all; } }

Save and close the file. Then enable the site and restart Nginx:

sudo ln -s /etc/nginx/sites-available/my_project /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl restart nginx

Test Your Setup: Open a browser and navigate to your domain or server IP. You should see the Symfony welcome page. If not, review the previous steps for typos or permission issues.
Secure with SSL (Optional): For production, install Certbot and obtain an SSL certificate to secure your site. Run:

sudo apt install certbot python3-certbot-nginx sudo certbot --nginx -d yourdomain.com

Follow the prompts to complete SSL setup.

Common Mistakes

Not updating the system before starting, which can lead to dependency issues.
Incorrect permissions on project files, preventing Nginx or PHP from accessing them.
Forgetting to create a symlink in sites-enabled or misconfiguring the server block.
Using the wrong PHP-FPM socket or version in the Nginx configuration.
Neglecting to restart PHP-FPM or Nginx after configuration changes.
Not securing the site with SSL in production, exposing data to potential threats.

Tips

Use a domain name instead of IP for easier SSL setup and better SEO.
Regularly update your server packages and Symfony dependencies for security and performance.
Use environment variables or a dedicated .env file to manage sensitive configuration values.
Set up automatic SSL renewal with Certbot to keep your site secure without manual intervention.
Consider using a process manager like Supervisor for background workers or queues if your app requires it.
Optimize PHP and Nginx configurations for better performance in production environments.

Troubleshooting

If your Symfony app does not load correctly or you encounter errors, try these steps:

Check Nginx error logs: sudo tail -f /var/log/nginx/error.log
Verify PHP-FPM is running: systemctl status php*-fpm
Ensure permissions are correct: ls -l /var/www/my_project
Test PHP processing independently: create a info.php file in your public directory with <?php phpinfo(); ?> and access it via browser.
Review your Nginx configuration syntax: sudo nginx -t
Clear Symfony cache: php bin/console cache:clear

Frequently Asked Questions

Can I run Symfony 5 with PHP 7.3? No, Symfony 5 requires PHP 7.2.5 or higher, but PHP 7.4 or 8.0 is recommended for best performance.
Is Nginx faster than Apache for Symfony? Generally, yes. Nginx is more efficient at handling static assets and concurrent connections, leading to better performance.
Do I need a database to run Symfony? Not necessarily. Symfony can run without a database, but most applications will require one such as MySQL, PostgreSQL, or SQLite.
How do I deploy updates after initial setup? Pull the latest code, run composer install, clear cache, and restart PHP-FPM and Nginx if needed.
Can I run Symfony in a Docker container instead? Yes, Docker is a popular choice for isolating environments and simplifying deployment, but this guide covers native installation on Ubuntu.
How do I troubleshoot performance issues? Enable Symfony profiler, review server logs, optimize PHP and Nginx configs, and consider caching strategies.

This comprehensive guide should help you successfully install and configure Symfony 5 with Nginx on Ubuntu Linux, setting a solid foundation for your web application development and deployment needs. Remember to keep your system and dependencies updated, secure your server, and monitor performance regularly for the best results.

How to Install Symfony 5 with Nginx on Ubuntu Linux

How to Install Symfony 5 with Nginx on Ubuntu Linux

What You’ll Need

Step-by-Step

Common Mistakes

Tips

Troubleshooting

Frequently Asked Questions

Related