How To Install MCrypt For PHP 8 On Ubuntu 20.04 LTS

If you are using the most recent versions of PHP and your project depends on MCrypt, you will get the error specific to Encrypt library which requires MCrypt extension. The main reason for missing MCrypt is that PHP no longer provides it by default and we must explicitly install it in order to continue using it.

Notes: This tutorial assumes that most recent version of PHP is already installed on the system. You can also follow the tutorial How To Install PHP 8 On Ubuntu 18.04 LTS  and How To Install PHP 8 On Ubuntu 20.04 LTS to install PHP 8 on Ubuntu.

Verify PHP

We can check the PHP version using the command as shown below.

# Check PHP version
php -version

# Output
PHP 8.0.5 (cli) (built: May  3 2021 11:30:57) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.5, Copyright (c) Zend Technologies
    with Zend OPcache v8.0.5, Copyright (c), by Zend Technologies

Install PHP Dev

Install the PHP development package using the below-mentioned command.

sudo apt install php8.0-dev

Install Build Tools

Install the build tools using the below-mentioned command.

sudo apt -y install gcc make autoconf libc-dev pkg-config

Install MCrypt Dev

Install the MCrypt development package using the below-mentioned command.

sudo apt-get -y install libmcrypt-dev

Install MCrypt

Install the most recent version of MCrypt using the below-mentioned command.

# Install MCrypt
sudo pecl install mcrypt-1.0.4

# Output
WARNING: channel "pecl.php.net" has updated its protocols, use "pecl channel-update pecl.php.net" to update
downloading mcrypt-1.0.4.tgz ...
Starting to download mcrypt-1.0.4.tgz (27,056 bytes)
.........done: 27,056 bytes
6 source files, building
running: phpize
Configuring for:
PHP Api Version:         20200930
Zend Module Api No:      20200930
Zend Extension Api No:   420200930
----
----

# Press enter on command prompt to complete installation
libmcrypt prefix? [autodetect] :

It will complete the installation and shows the success message as shown below.

Build process completed successfully
Installing '/usr/lib/php/20200930/mcrypt.so'
install ok: channel://pecl.php.net/mcrypt-1.0.4
configuration option "php_ini" is not set to php.ini location
You should add "extension=mcrypt.so" to php.ini

Configure PHP

Now configure the PHP by updating the php.ini file using the below-mentioned commands.

sudo bash -c "echo extension=/usr/lib/php/20200930/mcrypt.so > /etc/php/8.0/cli/conf.d/mcrypt.ini"
sudo bash -c "echo extension=/usr/lib/php/20200930/mcrypt.so > /etc/php/8.0/apache2/conf.d/mcrypt.ini"

At last, test your installation.

# Verify MCrypt
php -i | grep "mcrypt"

# Output
/etc/php/8.0/cli/conf.d/mcrypt.ini
Registered Stream Filters => zlib.*, string.rot13, string.toupper, string.tolower, convert.*, consumed, dechunk, convert.iconv.*, mcrypt.*, mdecrypt.*
mcrypt
mcrypt support => enabled
mcrypt_filter support => enabled
mcrypt.algorithms_dir => no value => no value
mcrypt.modes_dir => no value => no value

These are the steps required to install the MCrypt extension for the most recent version of PHP i.e. PHP 8. You can also refer How To Install MCrypt For PHP 7 On Ubuntu 20.04 LTS and How To Install MCrypt For PHP 7 On Ubuntu 18.04 LTS.

Summary

This tutorial provided the steps to install the most recent version of MCrypt for PHP 8. It also provided the resources to install PHP 8 on Ubuntu.