Skip to content
Simple PHP URL shortener, as used on
Branch: master
Clone or download
Pull request Compare This branch is even with mathiasbynens:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Simple PHP URL shortener

Requires PHP ≥ 5.4.0 or higher.


  1. Download the source code as located within this repository, and upload it to your web server.
  2. Use database.sql to create the redirect table in a database of choice. (Do not delete the INSERT statement on line 10 as it is needed to initialize the database.)
  3. Edit config.php and enter your database credentials.
  4. For additional security through obscurity™, consider renaming shorten.php to a secret file name of your choosing and tweaking the .htaccess file (line 3) accordingly.


  • Redirect to Twitter when given a numerical slug, e.g.
  • Redirect to your Twitter account when @ is used as a slug, e.g.
  • Redirect to your Google Plus account when + is used as a slug, e.g.
  • Redirect to your main website when no slug is entered, e.g.
  • Redirect to a specific page on your main website when an unknown slug (not in the database) is used, e.g.
  • Ignores weird trailing characters (!, ", #, $, %, &, ', (, ), *, +, ,, -, ., /, @, :, ;, <, =, >, [, \, ], ^, _, {, |, }, ~) in slugs — useful when your short URL is run through a crappy link parser, e.g. → same effect as visiting
  • Generates short, easy-to-type URLs using only [a-z] characters.
  • Doesn’t create multiple short URLs when you try to shorten the same URL. In this case, the script will simply return the existing short URL for that long URL.
  • DRY, minimal code.
  • Correct, semantic use of the available HTTP status codes.
  • Can be used with Twitter for iPhone. Just go to SettingsServicesURL ShorteningCustom… and enter http://yourshortener.ext/shorten?url=%@.

Favelets / Bookmarklets



Shorten this URL



This script is available under the MIT license.



You can’t perform that action at this time.