klokantech/tileserver-php

TileServer PHP：通过WMTS提供MapTiler和MBTiles地图

镜像概述和主要用途

TileServer PHP是一个免费开源的地图服务器，运行于Apache+PHP环境，实现OGC WMTS标准，用于分发预渲染的地图瓦片。支持MapTiler、GDAL2Tiles生成的瓦片或MBTiles文件，可向桌面、Web和移动应用提供地图服务，是通过普通Web主机以标准化方式提供可缩放地图的简单低成本方案。

核心功能和特性

• 多协议支持：实现OGC WMTS 1.0.0（KVP和RESTful）、OSGeo TMS 1.0.0（反y坐标）、TileJSON.js、XYZ瓦片请求及MapBox UTFgrid交互
• Web管理界面：提供地图列表展示和多客户端集成指南（Google Maps API、Leaflet、OpenLayers等）
• 高性能架构：静态瓦片由Apache直接提供，支持HTTP缓存头，仅XML元数据通过PHP处理
• 数据兼容性：支持MapTiler、GDAL2Tiles生成的瓦片目录及MBTiles文件（建议用mbutil解压MBTiles以提升性能）
• 多客户端兼容：适配QuantumGIS、ArcGIS、OpenLayers、MapBox.js等主流GIS软件和库

使用场景和适用范围

• Web应用地图图层集成（网站地图展示）
• 桌面GIS软件数据源（如QGIS、ArcGIS地图加载）
• 移动应用地图瓦片服务
• 低成本地图服务部署（适用于普通PHP虚拟主机）

详细的使用方法和配置说明

系统要求

• Apache Web服务器（需支持mod_rewrite和.htaccess）
• PHP 5.2及以上版本
• 或其他支持mod_rewrite规则和PHP的Web服务器

安装步骤

1. 下载项目文件：从https://github.com/klokantech/tileserver-php/archive/master.zip%E8%8E%B7%E5%8F%96ZIP%E5%8E%8B%E7%BC%A9%E5%8C%85%E6%88%96%E6%BA%90%E7%A0%81
2. 解压至Web主机目录：将文件解压到PHP启用的Web目录
3. 验证安装：访问安装目录URL，TileServer将显示欢迎信息和操作指南
4. 上传地图数据：
   • 上传MapTiler/GDAL2Tiles生成的瓦片目录
   • 或上传MBTiles文件（直接使用或通过https://github.com/mapbox/mbutil%E8%A7%A3%E5%8E%8B%E4%B8%BAXYZ%E7%BB%93%E6%9E%84%EF%BC%89

支持的协议及访问方式

OGC WMTS 1.0.0

• 标准：符合OGC Web地图瓦片服务规范，支持KVP和RESTful请求
• 基础地址：http://[域名]/[安装目录]/wmts
• GetCapabilities请求：
  • RESTful：http://[...]/1.0.0/WMTSCapabilities.xml
  • KVP：http://[...]?service=wmts&request=getcapabilities&version=1.0.0
• GetTile请求：
  • RESTful：http://[...]/layer/[可选参数][z]/[x]/[y].[ext]
  • KVP：http://[...]?service=wmts&request=getTile&layer=[layer]&tilematrix=[z]&tilerow=[y]&tilecol=[x]&format=[ext]

OSGeo TMS 1.0.0

• 特点：支持反y坐标的OSGeo瓦片服务，兼容OpenStreetMap瓦片服务器
• 访问地址：http://[...]/tms

TileJSON.js

• 功能：提供地图元数据，支持JSONP访问，符合MapBox TileJSON标准
• 访问地址：http://[...]/layer.jsonp

XYZ瓦片请求

• 兼容性：支持Google Maps API、Bing SDK、OpenStreetMap客户端
• 访问地址：http://[...]/layer/z/x/y.ext

MapBox UTFgrid请求

• 功能：支持MBTiles中的UTFgrid交互层，支持回调
• 访问地址：http://[...]/layer/z/x/y.grid.json

性能优化

• 多域名映射：配置多个域名（如a.example.com、b.example.com）通过DNS CNAME指向服务，突破浏览器并发请求限制，提升加载速度
• 静态瓦片优先：优先使用解压后的XYZ瓦片目录，由Apache直接提供服务，性能优于MBTiles文件

安全配置

密码保护

通过HTTP基本认证限制访问，编辑.htaccess文件添加：

apache
AuthUserFile /full/path/to/.htpasswd
AuthType Basic
AuthName "Secure WMTS"
Require valid-user

创建.htpasswd文件（用户:密码格式），可使用命令行工具：

bash
htpasswd -c .htpasswd [用户名]

或通过在线生成工具创建。

HTTPS/SSL支持

TileServer.php可直接在HTTPS环境下运行，无需额外配置。

Windows主机支持

• Apache环境：需安装PHP 5.2+及mod_rewrite模块
• IIS环境：需PHP和IIRF模块（[***]

测试过的WMTS/TMS客户端

• QuantumGIS Desktop 1.9+（通过Layer->Add WMS layer添加）
• ESRI ArcGIS Desktop 10.1+（原生支持WMTS）
• ESRI ArcGIS Online（通过WMTS协议加载）
• ArcBruTiles插件（ArcGIS 9.3+，通过TMS端点）
• OpenLayers WMTS Layer（支持解析GetCapabilities）
• GAIA（原生WMTS，3857投影问题待修复）
• MapBox.js（通过TileJSON加载，支持交互层）

许可证

BSD许可证（详见https://github.com/klokantech/tileserver-php%EF%BC%89

贡献者

• Petr Pridal - Klokan Technologies GmbH
• Jason Woolard - NOAA
• Jon Sellars - NOAA
• Dalibor Janak - Klokan Technologies GmbH