# Tile Proxy PHP: a simple caching-Proxy for WMTS Servers
This software should make it simple to use pre-rendered map tiles in your own projects, without flooding too many tiles-servers.
## Requirements:
- **Apache** webserver (with **_mod_rewrite_** / **_.htaccess_** support / **_php_curl_** extension)
- **PHP 5.3+**
## Installation:
Download project files and upload it into your web hosting of your choice.
Open the **"test.html"** file within your browser, the proxy server should display you a simple slippy map rendering the default Open Street Map tiles.
Or test directly in your browser with a tile URL such as: http://www.example.com/tiles/15/17024/10792.png
**NB.** Remeber to check your web server folder permissions: **777** or **755**
---
> _Initally based on the [work](https://wiki.openstreetmap.org/wiki/ProxySimplePHP) of **Lizard**_
---
## How to use
1. **edit the default "config.php"**
```php
/**
* Public App name.
*
* @var string
*/
$config['user_agent'] = 'Tile-Proxy-PHP/0.1';
/**
* Whitelist of supported tile servers
*
* @link https://wiki.openstreetmap.org/wiki/Tile_servers
*
* @var array
*/
$config['servers'] = array(
'osm' => 'https://{switch:a,b,c}.tile.openstreetmap.org/{z}/{x}/{y}.png',
'otm' => 'https://{switch:a,b,c}.tile.opentopomap.org/{z}/{x}/{y}.png',
// ADD: more services here.
);
/**
* Cached Bounding Box
*
* BBox = left, bottom, right, top
* BBox = min_lng, min_lat, max_lng, max_lat
*
* Planet: bbox = '-180,-90,180,90'
*
* @link https://openmaptiles.com/extracts/
*
* @var string
*/
// CHANGE: bounding box cache-area to fit your own needs
$config['bbox'] = '6.602696,35.07638,19.12499,47.10169'; // CHANGE: bbox tiles (Italy) are cached, others are proxied!
/**
* Cache timeout in seconds
*
* 12 hour = 43200 sec
* 1 day = 86400 sec
* 1 month = 2629800 sec
*
* @var int
*/
$config['ttl'] = 86400;
/**
* Custom Proxy Server headers
*
* @var string
*/
$config['headers'] = array(
'Access-Control-Allow-Origin:' => '*',
);
```
2. **create your first simple “tile-proxy-php” slippy map**
a. **_include CSS & JavaScript_**
```html
...
...
```
a. **_choose the div container used for the slippy map_**
```html
...
...
```
b. **_create the slippy map_**
```html
```
---
**Compatibile with:** php@5.38, curl@7.61
---
**Contributors:** [Lizard](https://wiki.openstreetmap.org/wiki/User:Lizard), [Raruto](https://github.com/Raruto/tile-proxy-php)
