Articles in this section

See more

How to install/uninstall memcached or memcache extension for Plesk PHP handlers?

Avatar
Nikita Nikushkin
Updated
Follow

Applicable to:

  • Plesk 12.5 for Linux
  • Plesk Onyx 17.5 for Linux
  • Plesk Onyx for Linux

Question

How to install/uninstall Memcached or Memcache extension for Plesk PHP handlers?

Answer

Since Memcache extensions are not included in Plesk PHP packages, they can only be installed manually. If you would like Memcache extensions pre-installed with Plesk PHP, please vote for this functionality on Plesk UserVoice. Top voted features are likely to be implemented in next product releases. Until Memcache is included in Plesk, it might be installed manually as described below.

Installing it manually is a viable option, however, read the following notes carefully before proceeding further:

Note: There are two Memcached implementations for PHP: memcache and memcached. memcache supports PHP 4.3.11 to PHP 5.6, while memcached supports PHP 5.4 to PHP 7.x.

Note: If /tmp is mounted with no-exec option, PECL will be unable to install modules. For more information, see this article: Error while using pecl install: shtool at /tmp does not exist or is not executable.

  1. At first, log into the server via SSH and prepare the environment:

    For rpm-based OS (CentOS, RHEL, CloudLinux)

    # wget -q -O - http://www.atomicorp.com/installers/atomic | sh
    # yum install memcached
    # yum install gcc libmemcached-devel zlib-devel
    # yum install plesk-php56-devel plesk-php70-devel plesk-php71-devel plesk-php72-devel plesk-php73-devel

    Note: Atomic repositories are being used instead of the CentOS ones because of newer package versions

    For deb-based OS (Debian, Ubuntu)

    # apt install memcached
    # apt install autoconf automake gcc libmemcached-dev libhashkit-dev pkg-config plesk-php..-dev zlib1g-dev

  2. Then, use one of the following instructions to install required modules:

    • Installation for PHP 7.x shipped with Plesk:

      Memcached installation

      Note: in the example below, instructions for PHP 7.0 are provided. Replace '7.0' with '7.1' to install the extension for PHP 7.1.

      1. Install the extension:

        # /opt/plesk/php/7.0/bin/pecl install memcached

      2. It might show the following warning. Just press 'Enter' without specifying anything to continue the installation:

        # /opt/plesk/php/7.0/bin/pecl install memcached
        pecl/memcached can optionally use PHP extension "igbinary" (version >= 2.0)
        pecl/memcached can optionally use PHP extension "msgpack" (version >= 2.0)
        downloading memcached-3.0.4.tgz ...
        Starting to download memcached-3.0.4.tgz (78,776 bytes)
        ..................done: 78,776 bytes
        15 source files, building
        running: phpize
        Configuring for:
        PHP Api Version: 20151012
        Zend Module Api No: 20151012
        Zend Extension Api No: 320151012
        libmemcached directory [no] :

      3. Register extension in configuration file:

        # echo "extension=memcached.so" > /opt/plesk/php/7.0/etc/php.d/memcached.ini

      4. Update PHP handlers information:

        # plesk bin php_handler --reread

      5. Restart Apache at Tools & Settings > Services Management or by any other means.

        Note: In case FPM service is used, it is required to restart FPM service as well. Can be done through Tools & Settings > Services Management or by any other means.

      Memcache installation

      Warning: memcache cannot be installed on PHP 7.x: https://bugs.php.net/bug.php?id=72887. Use memcached instead.

    • Installation for PHP 5.x shipped with Plesk:

      Memcached installation

      Note: For PHP 5.x php-memcached 2.x must be used. For PHP 5.2 the memcached-2.1.0 should be installed.

      1. Install the extension:

        # /opt/plesk/php/5.6/bin/pecl install memcached-2.2.0

        For PHP 5.2:

        # /opt/plesk/php/5.2/bin/pecl install memcached-2.1.0

      2. It might show the following warning. Just press 'Enter' without specifying anything to continue the installation:

        # /opt/plesk/php/5.6/bin/pecl install memcached-2.2.0
        pecl/memcached can optionally use PHP extension "igbinary" (version >= 2.0)
        pecl/memcached can optionally use PHP extension "msgpack" (version >= 2.0)
        downloading memcached-3.0.4.tgz ...
        Starting to download memcached-3.0.4.tgz (78,776 bytes)
        ..................done: 78,776 bytes
        15 source files, building
        running: phpize
        Configuring for:
        PHP Api Version: 20151012
        Zend Module Api No: 20151012
        Zend Extension Api No: 320151012
        libmemcached directory [no] :

      3. Register extension in configuration file:

        # echo "extension=memcached.so" > /opt/plesk/php/5.6/etc/php.d/memcached.ini

      4. Update PHP handlers information:

        # plesk bin php_handler --reread

      5. Restart Apache at Tools & Settings > Services Management or by any other means.

        Note: In case FPM service is used, it is required to restart FPM service as well. Can be done through Tools & Settings > Services Management or by any other means.

      Memcache installation

      1. Install the extension:

        # /opt/plesk/php/5.6/bin/pecl install memcache

      2. It might show the following warning. Just press 'Enter' without specifying anything to continue the installation:

        # /opt/plesk/php/5.6/bin/pecl install memcache
        downloading memcache-2.2.7.tgz ...
        Starting to download memcache-2.2.7.tgz (36,459 bytes)
        ..........done: 36,459 bytes
        11 source files, building
        WARNING: php_bin /opt/plesk/php/5.6/bin/php appears to have a suffix /5.6/bin/php, but config variable php_suffix does not match
        running: phpize
        Configuring for:
        PHP Api Version: 20131106
        Zend Module Api No: 20131226
        Zend Extension Api No: 220131226
        Enable memcache session handler support? [yes] :

      3. Register extension in configuration file:

        # echo "extension=memcache.so" > /opt/plesk/php/5.6/etc/php.d/memcache.ini

      4. Update PHP handlers information:

        # plesk bin php_handler --reread

      5. Restart Apache at Tools & Settings > Services Management or by any other means.

        Note: In case FPM service is used, it is required to restart FPM service as well. Can be done through Tools & Settings > Services Management or by any other means.

  3. To uninstall it, use the following guide:

    For memcached

    1. Remove memcached configuration file:

      # rm /opt/plesk/php/5.6/etc/php.d/memcached.ini

    2. Uninstall the extestion:

      # /opt/plesk/php/5.6/bin/pecl uninstall memcached

    3. Update PHP handlers information:

      # plesk bin php_handler --reread

    4. Restart Apache at Tools & Settings > Services Management or by any other means.

      Note: In case FPM service is used, it is required to restart FPM service as well. Can be done through Tools & Settings > Services Management or by any other means.

    For memcache

    1. Remove memcache configuration file:

      # rm /opt/plesk/php/5.6/etc/php.d/memcache.ini

    2. Uninstall the extension:

      # /opt/plesk/php/5.6/bin/pecl uninstall memcache

    3. Update PHP handlers information:

      # plesk bin php_handler --reread

    4. Restart Apache at Tools & Settings > Services Management or by any other means.

      Note: In case FPM service is used, it is required to restart FPM service as well. Can be done through Tools & Settings > Services Management or by any other means.

Additional Information

  • If you want to install Memcached extension on PHP 7.0 on Ubuntu 16.04 OS, follow these steps:

    Click here to see the additional information

    1. Install php7.0-dev and libmemcached-dev packages:

      # apt-get install php7.0-dev libmemcached-dev

    2. Remove -n flag from the last line of /usr/share/psa-pear/pear/pecl utility. It will look like:

      CONFIG_TEXT: exec $PHP -C -q $INCARG .....

    3. Run memcached installation:

      # /usr/share/psa-pear/pear/pecl install memcached

    4. Register the extension in the configuration file:

      # echo "extension=memcached.so" > /etc/php/7.0/cli/conf.d/20-memcached.ini

    5. Update PHP handlers information in Plesk:

      # plesk bin php_handler --reread

  • If you want to install Memcached extension on PHP 7.2 on Ubuntu 18.04 OS, follow these steps:

    Click here to see the additional information

    1. Install memcached service:

      # apt install memcached

    2. Install PHP Memcached module:

      # apt-get install php-memcached

    3. Update PHP handlers information in Plesk:

      # plesk bin php_handler --reread

    4. Restart the Apache service:

      # service apache2 restart

    5. Restart the system PHP service:

      # service php72-fpm restart

Comments

42 comments

Sort by Date Votes
  • Avatar
    Lethalmiko

    All these instructions don't work on Ubuntu 18.04.2 LTS with Plesk Onyx 17.8.11 Update #48. I am running nginx as a full front-line web server with FPM, not as a proxy. PHP version 7.2.15 supplied by vendor. The phpinfo does not show  memcached support. I verified that memcached is working. It is memcached version 1.5.6.

    I did two methods and they both failed!!! I uninstalled everything in between the two methods. I am stuck and don't know what to do.

    METHOD 1:
    # apt autoremove
    # apt install memcached
    # apt install autoconf automake gcc libmemcached-dev libhashkit-dev pkg-config plesk-php72-dev zlib1g-dev libsasl2-dev build-essential php7.2-dev
    # /opt/plesk/php/7.2/bin/pecl install memcached
    # echo "extension=memcached.so" > /opt/plesk/php/7.2/etc/php.d/memcached.ini
    # plesk bin php_handler --reread
    # /etc/init.d/php7.2-fpm restart && /etc/init.d/apache2 restart && /etc/init.d/nginx restart

    METHOD 2:
    # apt autoremove
    # apt install memcached
    # apt install autoconf automake gcc libmemcached-dev libhashkit-dev pkg-config plesk-php72-dev zlib1g-dev libsasl2-dev build-essential php7.2-dev

    [Edit pecl file]
    # nano /usr/share/psa-pear/pear/pecl
    ---
    Removed -n flag from the last line of /usr/share/psa-pear/pear/pecl utility. It is now:

    exec $PHP -C -q $INCARG -d date.timezone=UTC -d output_buffering=1 -d variables_order=EGPCS -d safe_mode=0 -d register_argc_argv="On" $INCDIR/peclcmd.php "$@"
    ---

    # /opt/plesk/php/7.2/bin/pecl install memcached
    # echo "extension=memcached.so" > /etc/php/7.2/cli/conf.d/20-memcached.ini
    # plesk bin php_handler --reread
    # /etc/init.d/php7.2-fpm restart && /etc/init.d/apache2 restart && /etc/init.d/nginx restart

    0
    Permalink
  • Avatar
    Nikita Nikushkin

    Hi @Lethalmiko,

    The provided solution is valid for Plesk PHP handlers only and does not work for system PHP

    I updated the article in order to avoid this misunderstanding and added the installation steps for "memcached" for OS PHP to the "Additional information" section as well

    Here are the steps for "memcached" installation for OS PHP:

    # apt install memcached
    # apt-get install php-memcached
    # plesk bin php_handler --reread
    # service apache2 restart
    # service php72-fpm restart

    After this, PHP info page started returning the "memcached"

    0
    Permalink
  • Avatar
    Lethalmiko

    @Nikita Nikushkin

    I actually ended up solving the problem myself with more research. What I did:

    ---

    # apt autoremove
    # apt install memcached
    # apt install autoconf automake gcc libmemcached-dev libhashkit-dev pkg-config plesk-php72-dev zlib1g-dev libsasl2-dev build-essential php7.2-dev

    # nano /usr/share/psa-pear/pear/pecl

    ---

    [Edited pecl file]

    Remove -n flag from the last line of /usr/share/psa-pear/pear/pecl utility. It is now:

    exec $PHP -C -q $INCARG -d date.timezone=UTC -d output_buffering=1 -d variables_order=EGPCS -d safe_mode=0 -d register_argc_argv="On" $INCDIR/peclcmd.php "$@"

    ---

    # /usr/share/psa-pear/pear/pecl install memcached
    [Installs to '/usr/lib/php/20170718/memcached.so']

    # echo "extension=memcached.so" > /etc/php/7.2/mods-available/memcached.ini
    # ln -s /etc/php/7.2/mods-available/memcached.ini /etc/php/7.2/cli/conf.d/20-memchached.ini
    # ln -s /etc/php/7.2/mods-available/memcached.ini /etc/php/7.2/fpm/conf.d/20-memchached.ini
    # plesk bin php_handler --reread
    # /etc/init.d/php7.2-fpm restart && /etc/init.d/apache2 restart && /etc/init.d/nginx restart

    0
    Permalink
  • Avatar
    Anna Morozyuk

    Hello @Lethalmiko,

    Thank you for the feedback! Other users may find this solution useful as well.

    0
    Permalink
  • Avatar
    Mario

    Hi, 

    Working with PHP7.3 only, do we need to install the plesk-php56-devel plesk-php70-devel plesk-php71-devel plesk-php72-devel?

    Also, I just copied and pasted the entire line, if answer to first question is no, can I simply 'yum remove plesk-php56-devel plesk-php70-devel plesk-php71-devel plesk-php72-devel' ?

    Thanks!

    0
    Permalink
  • Avatar
    Maxim Krasikov

    Hello @Mario !

    Since you use only PHP 7.3, you don't need to install plesk-php56-devel, plesk-php70-devel, plesk-php71-devel, and plesk-php72-devel packages.

    You may remove them using the following steps:

    1. List installed packages:
    # rpm -qa | grep devel | grep php
    plesk-php73-devel-7.3.5-1centos.7.190506.1021.x86_64
    plesk-php72-devel-7.2.18-1centos.7.190506.1021.x86_64
    plesk-php71-devel-7.1.29-1centos.7.190506.1021.x86_64
    plesk-php56-devel-5.6.40-centos7.19011112.x86_64


    2. Remove packages without dependensies one by one, for example:
    # rpm -evh --nodeps plesk-php56-devel
    # rpm -evh --nodeps plesk-php71-devel
    # rpm -evh --nodeps plesk-php72-devel

    0
    Permalink
  • Avatar
    Marcel Aulenbacher

    Hi! I am having issues on Ubuntu 14.04 Trusty with Plesk Onyx
    Version 17.8.11 Update #53

    I have different PHP Versions active on the server:
    5.5.9 which is solely needed by plesk in case I understand that right
    7.1 and 7.2

    I want to get memcached installed on the 7.1 and 7.2, yet I am using those PHP versions for the applications we are running.

    I get the following error following precisely the explanations given here:

    "/opt/plesk/php/7.1/bin$ sudo pecl install memcached
    pecl/memcached requires PHP (version >= 7.0.0), installed version is 5.5.9-1ubuntu4.29
    pecl/memcached can optionally use PHP extension "igbinary" (version >= 2.0)
    pecl/memcached can optionally use PHP extension "msgpack" (version >= 2.0)
    No valid packages found
    install failed"

    Installed memcached version is the latest release 1.5.1

    I am complying with each and any step given in the help section but there is no way to achieve it.

    Help would be much appreciated and thanks in advance!

    0
    Permalink
  • Avatar
    Maxim Krasikov (Edited )

    Hello @Marcel Aulenbacher!

    As I can see from the output provided, the command was executed under system PHP 5.5.9 but not under PHP 7.1.
    # /opt/plesk/php/7.1/bin$ sudo pecl install memcached

    Please install memcached using the commands provided in the instruction above in section "Memcached installation" for PHP 7.x.

    0
    Permalink
  • Avatar
    Marcel Aulenbacher

    Dear @Maxim Krasikow.

    Thank you for your reply. Using the root user php -v turns out to reply:

    PHP 7.1.29 (cli) (built: May 6 2019 11:09:56) ( NTS )
    Copyright (c) 1997-2018 The PHP Group
    Zend Engine v3.1.0, Copyright (c) 1998-2018 Zend Technologies
    with the ionCube PHP Loader (enabled) + Intrusion Protection from ioncube24.com (unconfigured) v10.2.1, Copyright (c) 2002-2018, by ionCube Ltd.
    with Zend OPcache v7.1.29, Copyright (c) 1999-2018, by Zend Technologies

    Could you please let me know what I have to do to execute the command under PHP 7.x?

    0
    Permalink
  • Avatar
    Nikita Nikushkin

    Hi @Marcel Aulenbacher,

    Please, run one of these commands to install the extension to the required Plesk PHP 7.X version:

    /opt/plesk/php/7.0/bin/pecl install memcached

    OR

    /opt/plesk/php/7.1/bin/pecl install memcached

    OR

    /opt/plesk/php/7.2/bin/pecl install memcached

    OR

    /opt/plesk/php/7.3/bin/pecl install memcached
    0
    Permalink
  • Avatar
    Marcel Aulenbacher (Edited )

    Hi @Nikita Nikushkin!

    Thank you for your input. As before mentioned and explained in my original post, this is exactly what I am doing with the root user. As furthermore described this results in the documented problems.

    The problem, as stated, is that apparantly the server tries to use PHP in the 5.6.9 version, even the root user is set to use PHP 7.1 for the execution of the commands.

    Regards!

    0
    Permalink
  • Avatar
    Nikita Nikushkin

    Hi @Marcel Aulenbacher,

    This error:

    "/opt/plesk/php/7.1/bin$ sudo pecl install memcached
    pecl/memcached requires PHP (version >= 7.0.0), installed version is 5.5.9-1ubuntu4.29
    pecl/memcached can optionally use PHP extension "igbinary" (version >= 2.0)
    pecl/memcached can optionally use PHP extension "msgpack" (version >= 2.0)
    No valid packages found
    install failed"

    Installed memcached version is the latest release 1.5.1

    is most probably occurs because sudoers run pecl under the system PHP

    I see that "php -v" returned the following:

    PHP 7.1.29 (cli) (built: May 6 2019 11:09:56) ( NTS )

    However, it returns the information for the Plesk PHP 7.1, not for the system one, for some reason

    I suggest repeat these steps:

    1. Login as a root user
    2. Run this command (without sudo):

    /opt/plesk/php/7.0/bin/pecl install memcached

    If the issue still occurs I suggest creating a request to the Support Department for further issue investigation:

    How to submit a request to Plesk support?

    0
    Permalink

Please sign in to leave a comment.

Have more questions? Submit a request

Related articles