{"id":24988,"date":"2025-09-08T12:00:00","date_gmt":"2025-09-08T10:00:00","guid":{"rendered":"https:\/\/contabo.com\/blog\/?p=24988"},"modified":"2025-09-20T20:49:10","modified_gmt":"2025-09-20T18:49:10","slug":"how-to-install-php-on-ubuntu-vps-a-comprehensive-guide","status":"publish","type":"post","link":"https:\/\/contabo.com\/blog\/how-to-install-php-on-ubuntu-vps-a-comprehensive-guide\/","title":{"rendered":"How to Install PHP on Ubuntu VPS \u2013 a Comprehensive Guide"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n
<\/div>\n\n\n\n

Installing PHP on Linux is a straightforward process, but doing it on a VPS gives you more control and flexibility. Whether you\u2019re setting up a new server for a project or migrating an existing site, a Linux PHP install ensures you can run frameworks and content management systems exactly the way you want. Using a PHP VPS means you can fine-tune performance, adjust configurations, and keep your environment secure.<\/p>\n\n\n\n

This guide walks you through how to install PHP on Linux distributions like Ubuntu, covering everything from updating package lists to configuring it with Nginx or Apache. You\u2019ll also learn how to add extensions, test your installation, and set up the server for long-term stability and performance.<\/p>\n\n\n\n

How to Install PHP on Ubuntu<\/strong><\/h2>\n\n\n\n

When it comes to installing PHP, Ubuntu offers a reliable and straightforward process. The official repositories include multiple PHP versions, so you can choose the one that best fits your project. Setting up PHP on Ubuntu is quick, and the same steps work across most modern Ubuntu releases.<\/p>\n\n\n\n

In the next subsections, we\u2019ll update the system\u2019s package list, install PHP itself, run command line tests, and set it up with popular web servers like Nginx and Apache. You\u2019ll also see how to install PHP extensions to add extra functionality for your applications.<\/p>\n\n\n\n

Package list update<\/strong><\/h2>\n\n\n\n

Before installing any software, it\u2019s best to make sure your system knows about the latest available packages. On Ubuntu, this is done with the apt update command. Open your terminal and run:<\/p>\n\n\n\n

sudo apt update<\/code><\/pre>\n\n\n\n
This refreshes the package index so your VPS can pull the newest versions from the repositories. Skipping this step might leave you with outdated dependencies, which could cause issues during or after the PHP installation.<\/p>\n\n\n\n
Install PHP on Ubuntu<\/strong><\/h2>\n\n\n\n
Once your package list is up to date, you can proceed with the installation. Ubuntu makes this easy with the apt package manager<\/a>. To perform an Ubuntu PHP install, run:<\/p>\n\n\n\n
sudo apt install php<\/code><\/pre>\n\n\n\n
This will install the default PHP version provided by Ubuntu\u2019s repositories, along with the basic modules needed for most applications.<\/p>\n\n\n\n
If you need a specific version, such as PHP 8.2, you can specify it explicitly:<\/p>\n\n\n\n
sudo apt install php8.2<\/code><\/pre>\n\n\n\n
After the process finishes, PHP is ready to use on your VPS. In the next step, we\u2019ll verify the installation from the command line.<\/p>\n\n\n\n
Command line PHP tests<\/strong><\/h2>\n\n\n\n
After installation, it\u2019s a good idea to confirm that PHP is working correctly from the terminal. This helps verify that the PHP command line interface is available and running the expected version.<\/p>\n\n\n\n
Check your PHP version with:<\/p>\n\n\n\n
php -v<\/code><\/pre>\n\n\n\n
You should see details about the installed version, along with build information. To run a quick test, you can also execute:<\/p>\n\n\n\n
php -r 'echo \"PHP is running\\n\";'<\/code><\/pre>\n\n\n\n
If you see the output without errors, your command line PHP setup is working as intended.<\/p>\n\n\n\n
Install PHP with Nginx<\/strong><\/h2>\n\n\n\n
If you\u2019re using Nginx as your web server, you\u2019ll need to install PHP along with PHP-FPM (FastCGI Process Manager) to handle dynamic content. Unlike Apache, Nginx doesn\u2019t process PHP natively, so PHP-FPM acts as the bridge between the server and your scripts.<\/p>\n\n\n\n
Install PHP-FPM with:<\/p>\n\n\n\n
sudo apt install php-fpm<\/code><\/pre>\n\n\n\n
Once installed, configure Nginx to pass PHP requests to PHP-FPM. Open your site\u2019s Nginx configuration file (usually in \/etc\/nginx\/sites-available\/) and update the server block with:<\/p>\n\n\n\n
location ~ \\.php$ {\n\n    include snippets\/fastcgi-php.conf;\n\n    fastcgi_pass unix:\/var\/run\/php\/php8.2-fpm.sock;\n\n}<\/code><\/pre>\n\n\n\n
Replace php8.2-fpm.sock with the correct version for your installation. After you configure Nginx, restart the server:<\/p>\n\n\n\n
sudo systemctl restart nginx<\/code><\/pre>\n\n\n\n
Your Nginx setup can now serve PHP pages without issues.<\/p>\n\n\n\n
Install PHP with Apache<\/strong><\/h2>\n\n\n\n
Apache can process PHP directly through the libapache2-mod-php module, making setup simple. To install PHP with Apache, run:<\/p>\n\n\n\n
sudo apt install php libapache2-mod-php<\/code><\/pre>\n\n\n\n
This will enable PHP support for your Apache server automatically. If you need a specific PHP version, include it in the command, for example:<\/p>\n\n\n\n
sudo apt install php8.2 libapache2-mod-php8.2<\/code><\/pre>\n\n\n\n
After installation, Apache will recognize and execute .php files without extra configuration. If you want to tweak settings or configure Apache for better performance, you can edit the PHP settings in \/etc\/php\/8.2\/apache2\/php.ini and then restart Apache:<\/p>\n\n\n\n
sudo systemctl restart apache2<\/code><\/pre>\n\n\n\n
Your server is now ready to serve PHP content through Apache.<\/p>\n\n\n\n
Install PHP extensions<\/strong><\/h2>\n\n\n\n
Many PHP applications require extra functionality beyond the core installation. This is where PHP extensions come in \u2014 they add features such as database drivers, image processing, or encryption support.<\/p>\n\n\n\n
To install PHP extensions, use:<\/p>\n\n\n\n
sudo apt install php-[extension_name]<\/code><\/pre>\n\n\n\n
For example, to enable MySQL support:<\/p>\n\n\n\n
sudo apt install php-mysql<\/code><\/pre>\n\n\n\n
You can install multiple extensions at once:<\/p>\n\n\n\n
sudo apt install php-mysql php-xml php-curl<\/code><\/pre>\n\n\n\n
After installing, restart your web server or PHP-FPM so the changes take effect. You can check which extensions are active by running:<\/p>\n\n\n\n
php -m<\/code><\/pre>\n\n\n\n
With the right extensions in place, PHP on your Ubuntu VPS can run a wider range of applications without compatibility issues.<\/p>\n\n\n\n
What to do after installing PHP on Ubuntu VPS<\/h2>\n\n\n\n
Once PHP is installed, there are a few important steps to prepare your server for real-world use.<\/p>\n\n\n\n
    \n
  1. Install a database server<\/strong>
    Most web applications need a database. You can install MySQL with:<\/li>\n<\/ol>\n\n\n\n
    sudo apt install mysql-server<\/code><\/pre>\n\n\n\n
    To learn more about configuring and using MySQL, check our guide: Open-Source Databases Series \u2013 MySQL<\/a>.<\/p>\n\n\n\n
    <\/a><\/a>Or, if you prefer MariaDB, run:<\/a><\/p>\n\n\n\n
    sudo apt install mariadb-server<\/code><\/pre>\n\n\n\n
    We also have a dedicated article for MariaDB here: Open-Source Databases Series \u2013 MariaDB<\/a>.[JN1]<\/a> [TM2]<\/a> [JN3]<\/a> <\/p>\n\n\n\n