Information for: DEVELOPERS   PARTNERS

Acquia Remote IDEs

Acquia Remote integrated development environments (IDEs) are browser-based, source code editors, and Drupal development stacks running in Acquia Cloud. Although Acquia Remote IDEs require Acquia Developer Studio CLI to be installed beforehand, you can access Acquia Remote IDEs without installing any extra software on your computer.

Requirements

Acquia Remote IDEs require the following software is installed on your local computer:

  • Acquia Developer Studio CLI (installation instructions)
  • The latest version of one of the following browsers:
    • Chrome
    • Edge
    • Firefox
    • Safari

Eligibility

Acquia Remote IDEs are available as an add-on feature for Acquia Cloud Enterprise subscriptions by contacting your Account Manager.

Acquia Remote IDEs aren’t available for subscribers with specific regulatory or compliance requirements.

Getting started

After installing Acquia Developer Studio CLI, install and configure Acquia Remote IDEs to provide an integrated development environment (IDE) for your use, after which you can then clone your Acquia Cloud application to your new IDE.

Managing existing integrated development environments

The following commands can help you manage your existing integrated development environments:

  • ads ide:list: Display a list of existing integrated development environments.
  • ads ide:open: Open an existing integrated development environment in your web browser.
  • ads ide:delete: Delete an existing integrated development environment.

Important

Deleting an integrated development environment deletes all information, files, and databases from that environment. Acquia cannot recover this data.

Understanding the user interface

Acquia Remote IDEs display the files and directories to which you have access in an Explorer pane to the left, and a code editor on the right providing access to your previously-opened content.

For more information about the user interface, see Using Acquia Remote IDEs. For information about configuring preferences in the user interface, see Settings and preferences.

Integrated development environment container resources

For a list of the tools, developer resources, and services available in the container of Acquia Remote IDEs, see Resources in Acquia Remote IDEs.

Using the Remote IDE terminal

The Acquia Developer Studio container provides a command-line terminal with access to the Bash shell. To learn more about using and configuring the terminal, see Using the terminal in Acquia Remote IDEs.

Working with PHP

The default PHP version for Acquia Remote IDEs is PHP 7.3. With Acquia Remote IDEs, you can configure the PHP version and Xdebug.

Configuring the PHP version

To configure the PHP version, complete the following steps:

  1. From the command line on your local computer, run the following command to open your IDE:

    ads ide:open
    
  2. In your IDE admin menu, go to Terminal > New Terminal.

  3. Create a /home/ide/configs/php/.version file by running the following command at the IDE terminal:

    echo "7.2" >> /home/ide/configs/php/.version
    

    This sets the PHP version to version 7.2. You can configure the PHP version to either PHP 7.2 or PHP 7.3.

    Note

    Acquia Remote IDEs don’t support PHP 7.4.

  4. Restart PHP-FPM to apply the changes you’ve made by running the following command:

    supervisorctl restart php-fpm
    

    The remote IDE will display the following text:

    ide:~/project$ supervisorctl restart php-fpm
    php-fpm: stopped
    php-fpm: started
    

Configuring PHP settings

To override the default PHP settings for Remote IDEs, you must change the following file:

/home/ide/configs/php/custom.ini

The PHP settings you can change include, but aren’t limited to the following:

  • memory_limit
  • upload_max_filesize
  • post_max_size
  • max_execution_time

Changes to PHP settings can display like the following example:

upload_max_filesize = 100M
post_max_size = 50M
max_execution_time = 240
memory_limit = 1G

To restart PHP-FPM to apply the changes you’ve made, follow step 4 in Configuring the PHP version.

Configuring Xdebug

Acquia Remote IDEs allow you to enable and disable Xdebug. To enable Xdebug in Remote IDE, complete the following steps:

  1. In your IDE, locate the /home/ide/configs/php/xdebug.ini file.

  2. Uncomment the following line by removing the semicolon at the beginning of the line:

    ;zend_extension=xdebug.so
    
  3. Restart PHP-FPM to apply the changes you’ve made by running the following command:

    supervisorctl restart php-fpm
    

To disable Xdebug in your remote IDE, complete the following steps:

  1. Locate the /home/ide/configs/php/xdebug.ini file.

  2. Comment out the following line by adding a semicolon at the beginning of the line:

    zend_extension=xdebug.so
    
  3. Restart PHP-FPM to apply the changes you’ve made by running the following command:

    supervisorctl restart php-fpm