How to Install PHP on Ubuntu Linux: A Complete Guide

PHP is a popular server-side scripting language widely used for building dynamic websites and web applications. Installing PHP on your Ubuntu Linux system is a crucial step if you want to run PHP-based projects, develop web apps locally, or set up a server environment. This guide walks you through the process of installing PHP on Ubuntu, ensuring you have a working PHP environment tailored to your needs. Before you begin, make sure your system is up to date and you have administrative (sudo) privileges to install packages.

What You’ll Need

• An Ubuntu Linux system (Ubuntu 20.04, 22.04, or later recommended)
• Root or sudo privileges on the system
• Internet connection to download necessary packages

Step-by-Step

1. Update Your System Packages

   Open your terminal and run the following commands to ensure your package list and installed packages are current:

   sudo apt update
   sudo apt upgrade -y

   This step helps prevent compatibility issues during installation.

2. Install PHP and Essential Modules

   Ubuntu’s default repositories include PHP packages. To install PHP along with some common modules needed for web development, run:

   sudo apt install php php-cli php-common php-mbstring php-xml php-mysql php-curl php-zip -y

   This command installs PHP and modules for command-line interface, XML processing, MySQL integration, cURL, and ZIP support.

3. Verify PHP Installation

   After installation completes, check the installed PHP version to confirm success:

   php -v

   You should see output indicating the PHP version installed, along with some configuration details.

4. Configure Your Web Server (Optional)

   If you plan to serve PHP scripts through a web server, install either Apache or Nginx. For Apache, run:

   sudo apt install apache2 -y

   After installing Apache, ensure PHP module is enabled and restart the server:

   sudo a2enmod php* 
   sudo systemctl restart apache2

   For Nginx, you’ll need to install PHP-FPM:

   sudo apt install php-fpm -y

   Configure your Nginx server block to use PHP-FPM for processing PHP files.

5. Create a Test PHP File

   Navigate to your web server’s root directory (e.g., /var/www/html) and create a test PHP file:

   sudo nano /var/www/html/info.php

   Add the following line to display PHP info:

   <?php phpinfo(); ?>

   Save and exit. Then, open your browser and visit http://your_server_ip/info.php to see the PHP information page.

Common Mistakes

• Not running system update before installation, leading to outdated packages or conflicts.
• Installing PHP without necessary modules, causing errors in scripts that rely on specific extensions.
• Forgetting to restart the web server after installing or enabling PHP modules, which prevents changes from taking effect.
• Using the wrong directory path for creating test PHP files, resulting in inaccessible pages.
• Confusing PHP CLI version with the web server PHP version; ensure both are compatible if they are different.

Tips

• Use the latest stable PHP version available in Ubuntu repositories or consider adding third-party PPAs for newer versions.
• Secure your PHP installation by disabling unnecessary modules and configuring php.ini settings for security.
• Regularly update PHP and related packages to benefit from security patches and new features.
• Use version control for your PHP scripts, especially when deploying to production environments.
• Test your PHP scripts in a local environment before deploying to a live server.

Troubleshooting

If you encounter issues during installation or PHP does not work as expected, consider the following steps:

• Check PHP Version: Run php -v to verify installation. If not installed, revisit the installation steps.
• Ensure Web Server is Running: For Apache, run sudo systemctl status apache2. For Nginx, run sudo systemctl status nginx.
• Verify PHP Module is Enabled: For Apache, run sudo a2enmod php* && sudo systemctl restart apache2. For Nginx with PHP-FPM, ensure the PHP-FPM service is active.
• Check Error Logs: Review web server logs located at /var/log/apache2/error.log or /var/log/nginx/error.log for clues.
• Test PHP Files: Confirm your PHP files are in the correct directory and accessible via your web server.
• Reinstall PHP: If problems persist, try removing and reinstalling PHP packages:

sudo apt remove php php-*- -y
sudo apt install php php-cli php-common -y

Frequently Asked Questions

1. Do I need to restart my server after installing PHP?

Generally, restarting your web server (Apache or Nginx) suffices. A full system restart is rarely necessary.

2. Can I install multiple PHP versions on Ubuntu?

Yes, but it requires adding specific repositories or using tools like PHP version managers. Be cautious to avoid conflicts.

3. How do I enable PHP modules I need?

Use sudo phpenmod module_name. For example, sudo phpenmod mbstring. Then restart your web server.

4. What is the difference between PHP CLI and PHP used in the web server?

The CLI version runs PHP scripts from the command line, while the web server version is configured to process PHP files served via HTTP. They may have different configurations and extensions enabled.

5. How do I upgrade PHP on Ubuntu?

Use a trusted PPA or repository that offers newer PHP versions, then update your packages with sudo apt update and sudo apt upgrade.

6. Is PHP installation secure by default?

Default installations are generally secure, but you should disable unused modules, configure php.ini settings for security, and keep PHP updated.

Following these steps ensures a smooth PHP setup on your Ubuntu system, whether for development, testing, or hosting web applications. Proper configuration and security practices will help you maintain a stable and secure environment for your PHP projects.

Related

• How to Install Linux on Windows 11 Step-by-Step Guide
• How to Install Linux in Windows 10 for a Dual Boot Setup
• How to Install LibreOffice on Ubuntu Linux Easily