Install PHsPeed

There are different ways to install PHsPeed. The most convenient way is to install PHsPeed AND the embedded PHsPeed-Xampp version. This way you will end up with a development environment where XDebug is correctly installed and where you can change the PHP version on the fly. It is possible to use any web server, see the section 'manual install'.

The standard PHsPeed Xampp version currently supports PHP 5.6, 7.0, 7.1 and 7.2. You can change the PHP version to be used in your IDE on the fly.

Important! PHsPeed is installed and maintained from the standard installer. This application will check for updates and inform you when there is an update. You MUST install PHsPeed and PHsPeed Xampp on the same disk so that the integrated IDE can find the installation. If you already have another Xampp version running and you want to install the PHsPeed distribution then pick another disk if you have one (i.e., D:\ instead of C:\) or, install it on a directory and create a mapping. In the application manager, you can easily define, and PHsPeed will create the mapping when needed.

If you don't have a secondary disk then you can create a virtual disk. If the installer does not recognise/find your primary Xampp package then you can create this virtual disk manually. Otherwise PHsPeed will do that for you.

To create a virtual disk, create a directory where you install PHsPeed, and Xampp, ie..c:\phspeedinstall. Then create a virtual disk by starting up cmd (command shell) and use command SUBS Z: c:\phspeedinstall to create a drive letter Z:

PHsPeed spawns the MySQL and Apache processes. Therefore when you start PHsPeed the configured applications are started and will be terminated when you stop the application.

Download the installer from our website and run it. The system will start up with a registration form. Use a valid email address and not a fake 10 minutes mail address. If you decide to continue with PHsPeed then you will not be able to change the fake address and thus are not able to register (if you decide not to continue with PHsPeed then you can remove your account completely, or we will do that for you. As a Dutch company we comply to the European privacy law (GDPR)).

From the installer, you can also install a PHsPeed version of Xampp. The Apache version uses a different port (configurable) then 80, so it can be installed beside your current web server. If you have already a MySQL/MariaDB instance running, you can disable the PHsPeed MySQL instance in the IDE. It is highly advised to use our Xampp distribution as it is pre-configured to run different PHP versions and is pre-configured for XDebug as well.

If you have a current instance of Xampp running, then you cannot 'just' install PHsPeed Xampp. Instead create a virtual disk, i.e. Z: to point to the second install. The installer can do that for you. Another option is to use a different drive if you have any.

In all cases, if you already have a wamp instance of any kind running, the create a full backup before installing PHsPeed to prevent data loss in case of issues.

Download the MSI on our website. Verify that this MSI is digitally signed by aducom software. All executables are digitally signed! Register and install the embedded wamp server and PHsPeed by following the presented steps.

Important! If you start PHsPeed the first time, then Windows firewall might complain. Apache and MySQL need to set to only listen to localhost or 127.0.0.1. PHsPeed needs access to the web for updates and license management.

Perform the automatic steps. Uncheck the MySQL checkbox. This setup is generally used for installing a second wamp package on your web server. The PHsPeed web server needs to be setup on another port than 80 (default is 8010).

Requirements: MsWindows, web server with XDebug enabled, PHP 5.6 and up and a database.

Installing PHsPeed is pretty straightforward. First, you need to download the installer from our website, unpack the executable from the zip file to the location where you want to setup PHsPeed and run. Fill in the required information and PHsPeed should install without problems. The PHsPeed installer must be in the same directory as the IDE as it will keep your installation in line with updates.

If you have already a web server environment, then you need to setup XDebug if you haven't done that.

Xampp? I don't use MySQL, but...

PHsPeed has been build en tested using PDO on MySQL, MariaDB, and SQLite. PDO is the database independent communication layer between any PDO supporting database and PHP. However, we do not know all the databases around. But if you know how to setup PDO for your database, then you should not have much trouble.

However, if you are not using MySQL/MariaDB, but other databases like Oracle, SQLServer, etc. then we would like to hear from you. Especially about the PDO-strings to be used.

I want to use my own web server!

It is possible to run PHsPeed with any web server that supports PHP 5.6 and up. However, you need to set up the system correctly so that PHsPeed knows it's port, the root directory and you must install and configure XDebug if you want to make use of the debugging facilities. Aducom Software does not give support in these matters.

Debugging

PHsPeed IDE has a XDebug client on board. To be able to use it you must make some changes to your php.ini file. The IDE will detect and report issues. With the integrated editors, you will be able to make the required modifications from within PHsPeed.

XDebug

Depending on your webserver it might be that your XDebug section is already in your php.ini file, but not enabled. Just set all disabled items to enabled. Another option is to startup PHsPeed, set up the basic preferences and then alter the php.ini within the IDE. On the right site of the screen, you will find the php.ini section. Click on the php.ini and the file will open in the editor. Don't forget to save your file after modification!

If the section is not in your php.ini, then it might be necessary to add the section yourself. On the website of XDebug.org, you can download the DLL. It has to match your PHP version as well as the exe type of your web server (32/64 bits).

Below are two sample versions, one for PHP 5 and one for PHP 7+. The DLL depends on the PHP version!

To setup xdebug use the following configuration in your php.ini file:

  • ; XDEBUG Extension
  • zend_extension = “c:/wamp/bin/php/php5.5.12/zend_ext/php_xdebug-2.2.5-5.5-vc11-x86_64.dll”;
  • ;
  • [xdebug]
  • xdebug.remote_enable = 1
  • xdebug.profiler_enable = 1
  • xdebug.profiler_enable_trigger = off
  • xdebug.profiler_output_name = cachegrind.out.%t.%p
  • xdebug.profiler_output_dir = “c:/wamp/tmp”
  • xdebug.show_local_vars=1

The zend_extension file is depending on the php version used. See XDebug.org for documentation and/or download.

  • [xdebug]
  • zend_extension =“D:/wamp/bin/php/php7.0.4/zend_ext/php_xdebug-2.4.0-7.0-vc14.dll”
  • xdebug.remote_enable=On
  • xdebug.remote_host=localhost
  • xdebug.remote_port=9000
  • xdebug.remote_handler=“dbgp”
  • xdebug.profiler_enable = 1
  • xdebug.profiler_enable_trigger = on
  • xdebug.profiler_output_name = cachegrind.out.%t.%p
  • xdebug.profiler_output_dir =“d:/wamp/tmp”
  • xdebug.show_local_vars=1

Start phSpeed. If this is the first time you ever run phpSpeed then it should guide you to the preference page. If it doesn't than that's the first thing you must do (tools → preferences).

  • In the generic section, select your web server package and click on the search icon. PHsPeed will try to find all the required directories. If it doesn't, or you don't want it to, then you can enter the directories manually. These directories are required for the good working of PHsPeed.
  • In the PDO section, you can enter your pdo strings. The basic strings are already there, but you might want or need to change them.
  • Click ok
  • Once in the IDE close the program and restart. Then all should work OK.