Toran Proxy A Composer proxy for speed and reliability

Download Toran Proxy for personal use.

Download   v1.5.3

Installation Instructions

Note that instructions are also available in the README file contained in the archive.

Trying it out / sandbox mode

If you want to try it out quickly, you can run Toran from an embedded PHP web server if you have php 5.4 or above by running the following command from within the toran directory: php app/console server:run --env=prod. However you should still follow points 1 to 4 below in the initial install instructions.

Initial install

  1. Extract the tgz archive in some directory
  2. Copy app/config/parameters.yml.dist to app/config/parameters.yml
  3. Tweak the values in app/config/parameters.yml to match the domain/path where you will host toran
  4. Make app/toran, app/cache, app/logs, web/repo and app/bootstrap.php.cache writable to (or owned by) the web user
  5. Ideally you should set up a vhost like toran.example.org pointing to the web/ directory.
    Apache should configure itself correctly with the .htaccess present in web/, but for nginx you should put something like this in the vhost:
    location / {
        try_files $uri /app.php$is_args$args;
    }
    
    location ~ ^/app\.php(/|$) {
        # The path or IP to access your PHP FCGI/FPM processes
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi_params;
        fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;
    
        # Set this to "off" if you are not using an ssl vhost
        fastcgi_param  HTTPS              on;
    }
    
    You should also think about securing the vhost with htpasswd/auth_basic rules.
  6. Run http://toran.example.org or if you have no vhost make sure you access the web/app.php file in your browser, the remaining steps of the installation will be detailed there.

Updates

When a new version of Toran Proxy is available, you can use the update command to download and install it. To do so open an ssh session and navigate to Toran's base directory. You can then run php app/console toran:update to start the process. If all happens successfully you should now be running the latest version.

In case the above did not work (if you host on Windows or have extremely restrictive permissions it might fail). You can also do a manual update by following these steps:

  1. Extract the new tgz archive over the existing one
  2. Clear the app/cache/prod directory
  3. That should be all!