We've created an install script to upgrade from php 5.3 to php 5.4. Since Stackato is based on Ubuntu 12.04 (LTS), and the default PHP release for 12.04 is 5.3, this script will use a non-default package repository to install 5.4. If interested, the repo being used is: https://launchpad.net/~ondrej/+archive/php5-oldstable. The scripts required to install this on Stackato 2.10.4 can be found at:

https://get.stackato.com/patch/2.10/stackato-php-5.4-installer.zip

To install, unzip the above file on all nodes running either the stager or DEA role. Once unzipped (ensure install.sh and container-upgrade-php.sh are in the same directory), execute install.sh via './install.sh'. You should be prompted to confirm running the script, and you may be asked for the node's sudo password.

A couple notes:
-This script executes a 'kato stop' command which will interrupt all stackato processes running on the node during the install process. After executing the script you will need to run 'kato start' on the node to bring everything back up.

-Suhosin is not included or compatible with PHP 5.4: https://pierre-schmitz.com/php-5-4-1-in-suhosin-out/, so that functionality is lost after you upgrade.

This usually means that your Komodo install isn't configured properly for the supported language.

Try checking the following to see if it helps:

• View > Start Page > Check Configuration: Make sure there are green check marks on your language.
• The file type (bottom of screen, language popup list).
• Preferences > Languages > your language > "Use this interpreter": "Browse" to the interpreter you want to use.

There is a known issue with Windows and Cygwin that overrides anything in your path. If you have done the above, you have Cygwin isntalled and on your system path, and debugging is still not working, you can do the following:

• Preferences > Environment > Double click "PATH" in the "Startup environment variables" section
• Double click "PATH" in the bottom section now
• Click the little double down arrows in the dialog that appears
• Find any references to Cygwin and delete it from the PATH

This will remove Cygwin from Komodo's reference of the system path and has no effect on your computer's system path. Remember you did this though! It will block Komodo from seeing other system path changes you may want Komodo to detect later on.

Cheers,

- Carey

Stackato ships with the current (at the time of release) version of the New Relic PHP Agent. If your system users need access to bug fixes or improvements from a subsequent release, you can update the relevant packages in the application container template.

Log in to the Stackato VM (each Stager and DEA in a cluster) as the 'stackato' user and run the following commands:

sudo chroot /lxc/template/rootfs
apt-get update
apt-get install newrelic-php5 newrelic-daemon

Subsequent PHP application deployments will have access to the updated New Relic PHP agent and daemon.

Warning: Updating random/all Ubuntu packages in a container template could break Stackato, but it is safe to update the newrelic packages.

Komodo 7.0.x is not compatible with PHP 5.4 yet. The new php_xdebug.* has not been release in the 7.0.x series.

You can either revert to PHP 5.3 until Komodo 7.1 is released

OR

Download the Komodo Nightly build which has the new php_xdebug.* file which is PHP 5.4 friendly. You can download the nightly here.

If you're still having problems getting PHP to play nice with Komodo you may not have PHP fully configured. That's covered over here.

WARNING! Failed to configure PHP debugging.
WARNING! Could not determine PHP version number.

You might have seen these errors before. You were installing PHP on your system and trying to run it in Komodo. This FAQ is to help you jump some configuration hurdles. It's easier than you think...

• Download and unpack the Zipped PHP to your machine. I put it in C:\php\.
• Configure Komodo to use PHP interpreter or put it on the PATH.
• Direct Komodo to the PHP interpreter:
• Edit->Preferences->Language->PHP:Use this interpreter.
• Click Browse.
• Navigate to the folder you unzipped PHP into.
• Select php.exe and click Open.
• Komodo will configure and let you know that Debugging is ready.
• Add C:\php\ to your system PATH.
• To confirm that PHP has configured properly using the System Path variable click Check Configuration on the Komodo Start page. PHP should get two brand new green check marks

There you go. Now start writing some PHP!

NOTE: You do NOT need the Debug Pack download for debugging in Komodo. Just download the Zip.

This is because your PHP CGI interpreter has been compiled with cgi.force_redirect set to on for security reasons. We can fix this in Komodo by changing this setting in the copy of php.ini that Komodo uses:

- open the php.ini copy that Komodo is using:

~/.komodo/host-<hostname>/php/<php-version>/php.ini

- change the setting:

; cgi.force_redirect = 1

to

cgi.force_redirect = 0

Save the php.ini, then try debugging using CGI Emulation again.

There are a couple of things you need to make sure of in order to get PHP remote debugging working:

1. xdebug must be configured correctly. The php.ini that your web server is using should contain statements like this:

; xdebug config for Linux and Mac OS X
zend_extension=/usr/share/php5/debug/xdebug.so
xdebug.remote_enable=1
xdebug.remote_handler=dbgp
xdebug.remote_mode=req
xdebug.remote_host=foo.bar.com
xdebug.remote_port=9000
xdebug.idekey=kyla

Note in particular that remote_host needs to be the hostname or ip address of the machine Komodo is running on, and remote_port needs to be the same as the remote port Komodo is using. You can check this by creating a script like this:

<?php phpinfo(); ?>

...and looking at the xdebug section in the output page.

2. Komodo must be configured correctly. At

Preferences / Debugger / Proxy

...set the field 'Listen for debug connections on port' to 9000 as above. Close the preferences and make sure that

Debug / Listen for remote debugger

...has a checkmark beside it.

3. You need to explicitly initiate a debugger session by adding the XDEBUG_SESSION_START get variable to the url in your browser:

http://baz.bar.com/script.php?XDEBUG_SESSION_START=1

If everything is correct, Komodo should pop-up a dialog inidicating that a remote application has requested a debugging session. If you click on 'OK', Komodo will step in to the first line of code in that script.

If this is still not working, some things to check are:

- can you ping the machine Komodo is running on form your web server?
- is the machine Komodo is on running some sort of software firewall that might be blocking the debugger requests?

1. Edit the php.ini file that Apache is using and add these values:

       zend_extension_ts=c:\path\to\php_xdebug.dll
       xdebug.remote_enable=1
       xdebug.remote_handler=dbgp
       xdebug.remote_mode=req
       xdebug.remote_host=127.0.0.1
       xdebug.remote_port=9000
       xdebug.idekey=1
   

   To verify that this is configured properly, create a script called 'info.php' containing the code:

       <?php phpinfo(); ?>
   

   You should see the xdebug extension settings section near the bottom of the output.

2. Open Komodo and go to Edit / Preferences / Debugger. Change the debugger
   listener port to 9000. Also, go into the 'Debug' menu and make sure the
   debugger listener is enabled.

3. Open up a browser window and point it at a PHP script on your local Apache,
   but first append the XDEBUG_SESSION_START variable to the url:

       http://localhost/index.php?XDEBUG_SESSION_START=1
   

   A dialog-box should appear in Komodo announcing that a remote debug session has been
   requested.

The version of PHP supplied with Mac OS X is not complied with
loadable extension support, so it is not compatible with Komodo's
debugger (Xdebug). For PHP debugging on OS X, either build PHP from
source with loadable extension support or use binaries from this
site:

http://www.entropy.ch/software/macosx/php/

The 4.3.11 or 5.0.4 for Apache 1 packages have been found to work
well with Komodo PHP debugging.