Installation and configuration
Depending on your PHP configuration, you may need to install these non-default modules:
You can check with your package manager for quick install. If you installed php using yum, you can just run:
yum install <modulename>
Note: If you find some other dependencies, please add them to the list.
ShowSlow requires MySQL v. 5+ although there is no particular feature identified that is a bottleneck here. You're still encouraged to use MySQL 5.5 and later for many other reasons.
Getting the code
Download latest version from here: http://www.showslow.org/downloads/
We're now on Github so you can get your copy directly from repository:
ShowSlow uses a few other projects which will be automatically checked out using git when you run
Create MySQL database and update config.php with database name, user and password.
You can use a tool like phpMyAdmin if you have it installed or just use a command like mysql client:
$ mysql -u root -p mysql> create database showslow; mysql> grant usage on showslow.* to showslowuser@localhost identified by '... database-password ...'; mysql> grant all privileges on showslow.* to showslowuser@localhost; mysql> quit
This is regular database creation step and has nothing specific to ShowSlow, use any database name and username you like.
Copy config.sample.php to config.php and change variables for your setup.
Database connection information
$db = 'showslow'; $user = 'showslowuser'; $pass = '... database-password ...'; $host = 'localhost';
Connecting using local socket
$db = 'showslow'; $user = 'showslowuser'; $pass = '... database-password ...'; $host = 'localhost:/var/lib/mysql/mysql.sock';
Best way to initialize or upgrade ShowSlow is to run
asset_versions.php and will run dbupgrade to make sure data structure is initialized and matches the code.
If you're afraid of running make
But if you're installing from a package (not from git) and are afraid of using
make for some reason, you can just initialize database by running
users/dbupgrade.php from command line or loading them in the browser.
As part of "Fast by default" movement, starting with version 0.6, Show Slow comes with drop-in .htaccess file that increases performance of the application (Show Slow uses SVN Assets project for asset versioning to avoid caching problems).
If you're using nginx instead of Apache, check out sample configuration file in SVN-Assets repository: http://code.google.com/p/svn-assets/source/browse/trunk/nginx.config_sample
Other web servers might have similar functionality. Please post your samples if you're going to configure them.
Advanced configuration options
Basic configuration options above are enough for you to get started, but if you like to get more features tweaked, check out: