Information for: DEVELOPERS   PARTNERS

Cloud IDE

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

Requirements

Cloud IDE requires the following software installed on your local computer:

Eligibility

Cloud IDE is available as an add-on feature for Cloud Platform subscriptions by contacting your Account Manager.

Cloud IDE isn’t available for subscribers with specific regulatory or compliance requirements.

Getting started

After installing Dev Studio CLI, install and configure Cloud IDE to provide an integrated development environment (IDE) for your use, after which you can then clone your Cloud Platform application to your new Cloud 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

Cloud IDE displays 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 Cloud IDE. 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 Cloud IDE container, see Resources in Cloud IDE.

Using the Cloud IDE terminal

The Dev 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 Cloud IDE.

Working with PHP

The default PHP version for Cloud IDE is PHP 7.3. With Cloud IDE, 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.4" >> /home/ide/configs/php/.version
    

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

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

    supervisorctl restart php-fpm
    

    The Cloud IDE will display the following text:

    ide:~/project$ supervisorctl restart php-fpm
    php-fpm: stopped
    php-fpm: started
    
  5. To apply the changes to PHP CLI, type bash in the terminal, or open up a new terminal. Confirm the PHP CLI version was updated with the below command.

    ide:~/project$ php -v
    PHP 7.4.6 (cli) (built: Jun  1 2020 17:56:08) ( NTS )
    Copyright (c) The PHP Group
    Zend Engine v3.4.0, Copyright (c) Zend Technologies
    

Configuring PHP settings

To override the default PHP settings for Cloud IDE, 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

Cloud IDE allows you to enable and disable Xdebug. To enable Xdebug in Cloud IDE, complete the following steps:

  1. In your Cloud 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 Cloud 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