PHP tools

Cloud IDE supports the following PHP tools:

Composer
Xdebug
PHP Code Sniffer
Drush
PHPUnit

Composer ¶

Cloud IDE supports Composer 2 to manage PHP dependencies. Composer 2 can be invoked by running the composer command. To view all Composer commands, visit the Composer documentation.

Xdebug ¶

Cloud IDE provides preconfigured Xdebug to help you debug Drupal applications.

Enabling or disabling Xdebug¶

In the Cloud IDE menu bar, click Terminal > New Terminal.

Run the acli ide:xdebug-toggle command to enable or disable Xdebug:

ide:~/project $ acli ide:xdebug-toggle
xDebug PHP extension enabled.
ide:~/project $ acli ide:xdebug-toggle
xDebug PHP extension disabled.

Editing the default settings of Xdebug¶

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

Edit the file to modify the required settings:

; Acquia Hosting XDebug defaults
; This file configures the default settings for xdebug.
[xdebug]
zend_extension=xdebug.so
xdebug.mode=develop
xdebug.client_host=127.0.0.1
xdebug.client_port=9001
xdebug.max_nesting_level=3000
xdebug.log = /tmp/fcso_debug.log

Restart FastCGI Process Manager (PHP-FPM) to implement the changes:
```
acli ide:service-restart php
```
For more information about using Xdebug with Cloud IDE, visit Using Xdebug.

Debugging Drush¶

In the Cloud IDE menu bar, click Terminal > New Terminal.
Add the DRUSH_ALLOW_XDEBUG=1 environment variable before your Drush command and then run the command to override the default behavior of the Drush launcher.
For example, to debug the pm:list Drush command, add a breakpoint to the pmList method in ./vendor/drush/drush/src/Drupal/Commands/pm/PmCommands.php, and run the following command:
```
DRUSH_ALLOW_XDEBUG=1 drush pm:list
```

PHP Code Sniffer ¶

Cloud IDE supports PHP Code Sniffer to help you write quality code. Cloud IDE enforces Drupal best practices with the pre-installed Drupal and DrupalPractice code sniffs.

ide:~/project (master) $ phpcs -i
The installed coding standards are MySource, PEAR, PSR1, PSR2, PSR12, Squiz, Zend, AcquiaDrupalStrict, AcquiaDrupalTransitional, AcquiaEdge, AcquiaPHP, Drupal, DrupalPractice, PHPCompatibility, VariableAnalysis and SlevomatCodingStandard.

To run PHP Code Sniffer against any supported Drupal file:

In the Cloud IDE menu bar, click Terminal > New Terminal.

Invoke the phpcs command and pass the path to the file or the directory:

ide:~/project (master) $ phpcs docroot/core/core.api.php
FILE: /home/ide/project/docroot/core/core.api.php
------------------------------------------------------------------------------
FOUND 13 ERRORS AND 1 WARNING AFFECTING 14 LINES
------------------------------------------------------------------------------
    8 | ERROR   | [ ] Missing short description in doc comment
  459 | WARNING | [ ] Line exceeds 80 characters; contains 82 characters
 1956 | ERROR   | [ ] Type hint "array" missing for $data_types
 1973 | ERROR   | [ ] Type hint "array" missing for $queues
 1992 | ERROR   | [ ] Missing parameter type
 2039 | ERROR   | [x] Doc comment short description must end with a full stop
 2045 | ERROR   | [ ] Missing parameter type
 2047 | ERROR   | [ ] Missing parameter type
 2068 | ERROR   | [ ] Missing parameter type
 2122 | ERROR   | [ ] Type hint "array" missing for $info
 2129 | ERROR   | [ ] Missing parameter type
 2158 | ERROR   | [ ] Type hint "array" missing for $definitions
 2232 | ERROR   | [ ] Type hint "array" missing for $sync_steps
 2254 | ERROR   | [ ] Missing parameter type
------------------------------------------------------------------------------
PHPCBF CAN FIX THE 1 MARKED SNIFF VIOLATIONS AUTOMATICALLY
------------------------------------------------------------------------------

Drush ¶

Cloud IDE supports Drush 8 for Drupal 7 applications. For the current Drupal version, the best practice is to add Drush to your composer.json file:

In the Cloud IDE menu bar, click Terminal > New Terminal.
Run the following command:
```
composer require drush/drush
```

PHPUnit ¶

Cloud IDE supports the following Drupal tests:

Unit tests
Kernel tests
Functional tests
Functional JavaScript tests with ChromeDriver

Reviewing environment variables¶

Cloud IDE requires multiple environment variables to run Drupal tests, and configures ChromeDriver to establish a connection with the database.

ide:~/project (master) $ env | grep -E '(TEST|DTT|MINK)'
MINK_DRIVER_ARGS_WEBDRIVER=["chrome", {"browserName":"chrome","chromeOptions":{"args":["--disable-gpu","--headless","--disable-dev-shm-usage"]}}, "http://127.0.0.1:4444"]
DTT_MINK_DRIVER_ARGS=["chrome", {"browserName":"chrome","chromeOptions":{"args":["--disable-gpu","--headless","--disable-dev-shm-usage"]}}, "http://127.0.0.1:4444"]
DTT_BASE_URL=http://127.0.0.1
SIMPLETEST_BASE_URL=http://127.0.0.1
SIMPLETEST_DB=mysql://drupal:[email protected]/drupal

Installing and running PHPUnit¶

To run Drupal tests, you need PHPUnit. To install PHPUnit, pull the Drupal development dependencies:

In the Cloud IDE menu bar, click Terminal > New Terminal.

Run the following command:

composer require --dev drupal/core-dev:*

The following is an example of a test executed within the docroot directory:

ide:~/project/docroot (master *) $ ../vendor/bin/phpunit -c core --debug --verbose --group=ban
PHPUnit 8.5.15 by Sebastian Bergmann and contributors.
Runtime:       PHP 7.4.14
Configuration: /home/ide/project/docroot/core/phpunit.xml.dist
Testing
Test 'Drupal\Tests\ban\Unit\BanMiddlewareTest::testBannedIp' started
Test 'Drupal\Tests\ban\Unit\BanMiddlewareTest::testBannedIp' ended
Test 'Drupal\Tests\ban\Unit\BanMiddlewareTest::testUnbannedIp' started
Test 'Drupal\Tests\ban\Unit\BanMiddlewareTest::testUnbannedIp' ended
Test 'Drupal\Tests\ban\Kernel\Plugin\migrate\source\d7\BlockedIpsTest::testSource with data set #0 (array(array(array(1, '127.0.0.1'))), array(array('127.0.0.1')))' started
Test 'Drupal\Tests\ban\Kernel\Plugin\migrate\source\d7\BlockedIpsTest::testSource with data set #0 (array(array(array(1, '127.0.0.1'))), array(array('127.0.0.1')))' ended
Test 'Drupal\Tests\ban\Kernel\Migrate\d7\MigrateBlockedIpsTest::testBlockedIps' started
Test 'Drupal\Tests\ban\Kernel\Migrate\d7\MigrateBlockedIpsTest::testBlockedIps' ended
Test 'Drupal\Tests\ban\Functional\IpAddressBlockingTest::testIPAddressValidation' started
Test 'Drupal\Tests\ban\Functional\IpAddressBlockingTest::testIPAddressValidation' ended
Time: 17.94 seconds, Memory: 853.00 MB
OK (5 tests, 41 assertions)

Running functional JavaScript tests¶

Run ChromeDriver before you execute Drupal’s functional JavaScript tests.

To launch ChromeDriver:

In the Cloud IDE menu bar, click Terminal > New Terminal.

Run the following command:

ide:~/project/docroot (master *) $ chromedriver --port=4444&
[1] 4838
Starting ChromeDriver 89.0.4389.23 (61b08ee2c50024bab004e48d2b1b083cdbdac579-refs/branch-heads/4389@{#294}) on port 4444
Only local connections are allowed.
Please see https://chromedriver.chromium.org/security-considerations for suggestions on keeping ChromeDriver safe.
ChromeDriver was started successfully.

To allow the process to continue running in the background, pass the & character at the end of the command.

Run functional JavaScript tests after ChromeDriver is launched:

ide:~/project/docroot (master *) $ ../vendor/bin/phpunit -c core --debug --verbose core/modules/user/tests/src/FunctionalJavascript
PHPUnit 8.5.15 by Sebastian Bergmann and contributors.
Runtime:       PHP 7.4.14
Configuration: /home/ide/project/docroot/core/phpunit.xml.dist
Testing core/modules/user/tests/src/FunctionalJavascript
Test 'Drupal\Tests\user\FunctionalJavascript\RegistrationWithUserFieldsTest::testRegistrationWithUserFields' started
Test 'Drupal\Tests\user\FunctionalJavascript\RegistrationWithUserFieldsTest::testRegistrationWithUserFields' ended
Test 'Drupal\Tests\user\FunctionalJavascript\UserPasswordResetTest::testUserPasswordResetWithAdditionalAjaxForm' started
Test 'Drupal\Tests\user\FunctionalJavascript\UserPasswordResetTest::testUserPasswordResetWithAdditionalAjaxForm' ended
Time: 28.88 seconds, Memory: 8.00 MB
OK (2 tests, 10 assertions)

After running functional JavaScript tests, terminate the ChromeDriver process to free up CPU and memory in your IDE.
```
ide:~/project/docroot (master *) $ pkill chromedriver
[1]+  Terminated              chromedriver --port=4444
```

For more information about Drupal tests, visit Running PHPUnit tests.

Did not find what you were looking for?

If this content did not answer your questions, try searching or contacting our support team for further assistance.

Cloud IDE Support

Cloud IDE supports the following PHP tools:

Composer
Xdebug
PHP Code Sniffer
Drush
PHPUnit

Composer ¶

Cloud IDE supports Composer 2 to manage PHP dependencies. Composer 2 can be invoked by running the composer command. To view all Composer commands, visit the Composer documentation.

Xdebug ¶

Cloud IDE provides preconfigured Xdebug to help you debug Drupal applications.

Enabling or disabling Xdebug¶

In the Cloud IDE menu bar, click Terminal > New Terminal.

Run the acli ide:xdebug-toggle command to enable or disable Xdebug:

ide:~/project $ acli ide:xdebug-toggle
xDebug PHP extension enabled.
ide:~/project $ acli ide:xdebug-toggle
xDebug PHP extension disabled.

Editing the default settings of Xdebug¶

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

Edit the file to modify the required settings:

; Acquia Hosting XDebug defaults
; This file configures the default settings for xdebug.
[xdebug]
zend_extension=xdebug.so
xdebug.mode=develop
xdebug.client_host=127.0.0.1
xdebug.client_port=9001
xdebug.max_nesting_level=3000
xdebug.log = /tmp/fcso_debug.log

Restart FastCGI Process Manager (PHP-FPM) to implement the changes:
```
acli ide:service-restart php
```
For more information about using Xdebug with Cloud IDE, visit Using Xdebug.

Debugging Drush¶

In the Cloud IDE menu bar, click Terminal > New Terminal.
Add the DRUSH_ALLOW_XDEBUG=1 environment variable before your Drush command and then run the command to override the default behavior of the Drush launcher.
For example, to debug the pm:list Drush command, add a breakpoint to the pmList method in ./vendor/drush/drush/src/Drupal/Commands/pm/PmCommands.php, and run the following command:
```
DRUSH_ALLOW_XDEBUG=1 drush pm:list
```

PHP Code Sniffer ¶

Cloud IDE supports PHP Code Sniffer to help you write quality code. Cloud IDE enforces Drupal best practices with the pre-installed Drupal and DrupalPractice code sniffs.

ide:~/project (master) $ phpcs -i
The installed coding standards are MySource, PEAR, PSR1, PSR2, PSR12, Squiz, Zend, AcquiaDrupalStrict, AcquiaDrupalTransitional, AcquiaEdge, AcquiaPHP, Drupal, DrupalPractice, PHPCompatibility, VariableAnalysis and SlevomatCodingStandard.

To run PHP Code Sniffer against any supported Drupal file:

In the Cloud IDE menu bar, click Terminal > New Terminal.

Invoke the phpcs command and pass the path to the file or the directory:

ide:~/project (master) $ phpcs docroot/core/core.api.php
FILE: /home/ide/project/docroot/core/core.api.php
------------------------------------------------------------------------------
FOUND 13 ERRORS AND 1 WARNING AFFECTING 14 LINES
------------------------------------------------------------------------------
    8 | ERROR   | [ ] Missing short description in doc comment
  459 | WARNING | [ ] Line exceeds 80 characters; contains 82 characters
 1956 | ERROR   | [ ] Type hint "array" missing for $data_types
 1973 | ERROR   | [ ] Type hint "array" missing for $queues
 1992 | ERROR   | [ ] Missing parameter type
 2039 | ERROR   | [x] Doc comment short description must end with a full stop
 2045 | ERROR   | [ ] Missing parameter type
 2047 | ERROR   | [ ] Missing parameter type
 2068 | ERROR   | [ ] Missing parameter type
 2122 | ERROR   | [ ] Type hint "array" missing for $info
 2129 | ERROR   | [ ] Missing parameter type
 2158 | ERROR   | [ ] Type hint "array" missing for $definitions
 2232 | ERROR   | [ ] Type hint "array" missing for $sync_steps
 2254 | ERROR   | [ ] Missing parameter type
------------------------------------------------------------------------------
PHPCBF CAN FIX THE 1 MARKED SNIFF VIOLATIONS AUTOMATICALLY
------------------------------------------------------------------------------

Drush ¶

Cloud IDE supports Drush 8 for Drupal 7 applications. For the current Drupal version, the best practice is to add Drush to your composer.json file:

In the Cloud IDE menu bar, click Terminal > New Terminal.
Run the following command:
```
composer require drush/drush
```

PHPUnit ¶

Cloud IDE supports the following Drupal tests:

Unit tests
Kernel tests
Functional tests
Functional JavaScript tests with ChromeDriver

Reviewing environment variables¶

Cloud IDE requires multiple environment variables to run Drupal tests, and configures ChromeDriver to establish a connection with the database.

ide:~/project (master) $ env | grep -E '(TEST|DTT|MINK)'
MINK_DRIVER_ARGS_WEBDRIVER=["chrome", {"browserName":"chrome","chromeOptions":{"args":["--disable-gpu","--headless","--disable-dev-shm-usage"]}}, "http://127.0.0.1:4444"]
DTT_MINK_DRIVER_ARGS=["chrome", {"browserName":"chrome","chromeOptions":{"args":["--disable-gpu","--headless","--disable-dev-shm-usage"]}}, "http://127.0.0.1:4444"]
DTT_BASE_URL=http://127.0.0.1
SIMPLETEST_BASE_URL=http://127.0.0.1
SIMPLETEST_DB=mysql://drupal:[email protected]/drupal

Installing and running PHPUnit¶

To run Drupal tests, you need PHPUnit. To install PHPUnit, pull the Drupal development dependencies:

In the Cloud IDE menu bar, click Terminal > New Terminal.

Run the following command:

composer require --dev drupal/core-dev:*

The following is an example of a test executed within the docroot directory:

ide:~/project/docroot (master *) $ ../vendor/bin/phpunit -c core --debug --verbose --group=ban
PHPUnit 8.5.15 by Sebastian Bergmann and contributors.
Runtime:       PHP 7.4.14
Configuration: /home/ide/project/docroot/core/phpunit.xml.dist
Testing
Test 'Drupal\Tests\ban\Unit\BanMiddlewareTest::testBannedIp' started
Test 'Drupal\Tests\ban\Unit\BanMiddlewareTest::testBannedIp' ended
Test 'Drupal\Tests\ban\Unit\BanMiddlewareTest::testUnbannedIp' started
Test 'Drupal\Tests\ban\Unit\BanMiddlewareTest::testUnbannedIp' ended
Test 'Drupal\Tests\ban\Kernel\Plugin\migrate\source\d7\BlockedIpsTest::testSource with data set #0 (array(array(array(1, '127.0.0.1'))), array(array('127.0.0.1')))' started
Test 'Drupal\Tests\ban\Kernel\Plugin\migrate\source\d7\BlockedIpsTest::testSource with data set #0 (array(array(array(1, '127.0.0.1'))), array(array('127.0.0.1')))' ended
Test 'Drupal\Tests\ban\Kernel\Migrate\d7\MigrateBlockedIpsTest::testBlockedIps' started
Test 'Drupal\Tests\ban\Kernel\Migrate\d7\MigrateBlockedIpsTest::testBlockedIps' ended
Test 'Drupal\Tests\ban\Functional\IpAddressBlockingTest::testIPAddressValidation' started
Test 'Drupal\Tests\ban\Functional\IpAddressBlockingTest::testIPAddressValidation' ended
Time: 17.94 seconds, Memory: 853.00 MB
OK (5 tests, 41 assertions)

Running functional JavaScript tests¶

Run ChromeDriver before you execute Drupal’s functional JavaScript tests.

To launch ChromeDriver:

In the Cloud IDE menu bar, click Terminal > New Terminal.

Run the following command:

ide:~/project/docroot (master *) $ chromedriver --port=4444&
[1] 4838
Starting ChromeDriver 89.0.4389.23 (61b08ee2c50024bab004e48d2b1b083cdbdac579-refs/branch-heads/4389@{#294}) on port 4444
Only local connections are allowed.
Please see https://chromedriver.chromium.org/security-considerations for suggestions on keeping ChromeDriver safe.
ChromeDriver was started successfully.

To allow the process to continue running in the background, pass the & character at the end of the command.

Run functional JavaScript tests after ChromeDriver is launched:

ide:~/project/docroot (master *) $ ../vendor/bin/phpunit -c core --debug --verbose core/modules/user/tests/src/FunctionalJavascript
PHPUnit 8.5.15 by Sebastian Bergmann and contributors.
Runtime:       PHP 7.4.14
Configuration: /home/ide/project/docroot/core/phpunit.xml.dist
Testing core/modules/user/tests/src/FunctionalJavascript
Test 'Drupal\Tests\user\FunctionalJavascript\RegistrationWithUserFieldsTest::testRegistrationWithUserFields' started
Test 'Drupal\Tests\user\FunctionalJavascript\RegistrationWithUserFieldsTest::testRegistrationWithUserFields' ended
Test 'Drupal\Tests\user\FunctionalJavascript\UserPasswordResetTest::testUserPasswordResetWithAdditionalAjaxForm' started
Test 'Drupal\Tests\user\FunctionalJavascript\UserPasswordResetTest::testUserPasswordResetWithAdditionalAjaxForm' ended
Time: 28.88 seconds, Memory: 8.00 MB
OK (2 tests, 10 assertions)

After running functional JavaScript tests, terminate the ChromeDriver process to free up CPU and memory in your IDE.
```
ide:~/project/docroot (master *) $ pkill chromedriver
[1]+  Terminated              chromedriver --port=4444
```

For more information about Drupal tests, visit Running PHPUnit tests.

Did not find what you were looking for?

If this content did not answer your questions, try searching or contacting our support team for further assistance.

Cloud IDE Support

Company

Partners

Support

Composer ¶

Xdebug ¶

Enabling or disabling Xdebug¶

Editing the default settings of Xdebug¶

Debugging Drush¶

PHP Code Sniffer ¶

Drush ¶

PHPUnit ¶

Reviewing environment variables¶

Installing and running PHPUnit¶

Running functional JavaScript tests¶

Did not find what you were looking for?

Composer ¶

Xdebug ¶

Enabling or disabling Xdebug¶

Editing the default settings of Xdebug¶

Debugging Drush¶

PHP Code Sniffer ¶

Drush ¶

PHPUnit ¶

Reviewing environment variables¶

Installing and running PHPUnit¶

Running functional JavaScript tests¶

Did not find what you were looking for?

Loading...

Loading...

Enabling or disabling Xdebug¶

Editing the default settings of Xdebug¶

Debugging Drush¶

Reviewing environment variables¶

Installing and running PHPUnit¶

Running functional JavaScript tests¶

Did not find what you were looking for?

PHP tools

Enabling or disabling Xdebug¶

Editing the default settings of Xdebug¶

Debugging Drush¶

Reviewing environment variables¶

Installing and running PHPUnit¶

Running functional JavaScript tests¶

Did not find what you were looking for?