README

geophp.net

GeoPHP 是一个用于进行几何运算的开源原生 PHP 库。它完全由 PHP 编写，因此可以在共享主机上运行。它可以读取和写入多种格式：WKT（包括 EWKT）、WKB（包括 EWKB）、GeoJSON、KML、GPX 和 GeoRSS。它支持所有 Simple-Feature 地理形状（点、线字符串、多边形、几何集合等），并可用于获取质心、边界框、面积和其他各种有用信息。

geoPHP 还友好地包装了 GEOS php 扩展，以便当服务器上安装了 GEOS 时，应用程序可以获得透明的性能提升。当安装了 GEOS 时，geoPHP 也完全符合 OpenGIS® 地理信息实施标准。使用 GEOS，您可以在 PHP 中获得完整的 OpenGIS 函数集，如并集、IsWithin、Touches 等。这意味着应用程序获得了一个有用的“核心集”几何运算，这些运算在所有环境中都有效，以及一个“扩展集”运算，用于已安装 GEOS 的环境。

请参阅下面的“入门”部分，了解 geoPHP 可以执行的所有内容的参考和示例。

该项目目前正在寻找共同维护者。如果您认为您可以帮助，请给我发消息。分支也欢迎，请发起拉取请求，我将将其合并到主分支。

入门

最新稳定版本始终可以在以下位置下载： https://phayes.github.io/bin/current/geoPHP/geoPHP.tar.gz
在以下位置阅读 API 参考：https://geophp.net/api.html
示例
- 将 geoPHP 作为 GIS 格式转换器使用：http://github.com/phayes/geoPHP/wiki/Example-format-converter
其他有趣链接
- 了解 GEOS 集成： https://geophp.net/geos.html

示例用法

<?php
use src\geoPhp;include_once('geoPHP.inc');

// Polygon WKT example
$polygon = geoPhp::load('POLYGON((1 1,5 1,5 5,1 5,1 1),(2 2,2 3,3 3,3 2,2 2))','wkt');
$area = $polygon->getArea();
$centroid = $polygon->getCentroid();
$centX = $centroid->getX();
$centY = $centroid->getY();

print "This polygon has an area of ".$area." and a centroid with X=".$centX." and Y=".$centY;

// MultiPoint json example
print "<br/>";
$json = 
'{
   "type": "MultiPoint",
   "coordinates": [
       [100.0, 0.0], [101.0, 1.0]
   ]
}';

$multipoint = geoPhp::load($json, 'json');
$multipoint_points = $multipoint->getComponents();
$first_wkt = $multipoint_points[0]->out('wkt');

print "This multipoint has ".$multipoint->numGeometries()." points. The first point has a wkt representation of ".$first_wkt;

=======

更多示例

Well Known Text (WKT) 和 Well Known Binary (WKB) 的支持非常适合与 MySQL 或 PostGIS 的空间功能集成。一旦您使用 'AsText('geo_field')' 或 'AsBinary('geo_field')' 选择了您的数据，就可以直接将其放入 geoPHP（可以是 wkt 或 wkb，但必须与您从数据库中提取的方式相同）

$geom = geoPHP::load($dbRow,'wkt');

您可以将多个几何形状收集到一起（注意，您必须使用 wkt 做这件事）

$geom = geoPHP::load("GEOMETRYCOLLECTION(".$dbString1.",".$dbString2.")",'wkt');

调用 get components 返回几何形状内的子几何形状作为数组。

$geom2 = geoPHP::load("GEOMETRYCOLLECTION(LINESTRING(1 1,5 1,5 5,1 5,1 1),LINESTRING(2 2,2 3,3 3,3 2,2 2))");
$geomComponents = $geom2->getComponents();    //an array of the two linestring geometries
$linestring1 = $geomComponents[0]->getComponents();	//an array of the first linestring's point geometries
$linestring2 = $geomComponents[1]->getComponents();
echo $linestring1[0]->x() . ", " . $linestring1[0]->y();    //outputs '1, 1'

另一种选择是使用 asArray() 方法。使用上述包含两个线字符串的几何集合，

$geometryArray = $geom2->asArray();
echo $geometryArray[0][0][0] . ", " . $geometryArray[0][0][1];    //outputs '1, 1'

显然，可以进行更复杂的分析。

echo $geom2->envelope()->area();

与 PostGIS 一起工作

通过其 EWKB 适配器，geoPHP 与 postGIS 具有良好的集成。以下是一个读取和写入 postGIS 几何形状的示例

<?php
use src\geoPhp;include_once('geoPHP.inc');
$host =     'localhost';
$database = 'phayes';
$table =    'test';
$column =   'geom';
$user =     'phayes';
$pass =     'supersecret';

$connection = pg_connect("host=$host dbname=$database user=$user password=$pass");

// Working with PostGIS and Extended-WKB
// ----------------------------

// Using asBinary and GeomFromWKB in PostGIS
$result = pg_fetch_all(pg_query($connection, "SELECT asBinary($column) as geom FROM $table"));
foreach ($result as $item) {
  $wkb = pg_unescape_bytea($item['geom']); // Make sure to unescape the hex blob
  $geom = geoPhp::load($wkb, 'ewkb'); // We now a full geoPHP Geometry object
  
  // Let's insert it back into the database
  $insert_string = pg_escape_bytea($geom->out('ewkb'));
  pg_query($connection, "INSERT INTO $table ($column) values (GeomFromWKB('$insert_string'))");
}

// Using a direct SELECT and INSERTs in PostGIS without using wrapping functions
$result = pg_fetch_all(pg_query($connection, "SELECT $column as geom FROM $table"));
foreach ($result as $item) {
  $wkb = pack('H*',$item['geom']);   // Unpacking the hex blob
  $geom = geoPhp::load($wkb, 'ewkb'); // We now have a geoPHP Geometry
  
  // To insert directly into postGIS we need to unpack the WKB
  $unpacked = unpack('H*', $geom->out('ewkb'));
  $insert_string = $unpacked[1];
  pg_query($connection, "INSERT INTO $table ($column) values ('$insert_string')");
}

致谢

维护者：Patrick Hayes

其他贡献者

GeoMemes 研究 (http://www.geomemes.com)
HighWire Press (http://www.highwire.org) 和 GeoScienceWorld (http://www.geoscienceworld.org)
Arnaud Renevier (gisconverter.php) https://github.com/arenevier/gisconverter.php
Dave Tarc https://github.com/dtarc
Elliott Hunston (文档) https://github.com/ejh

此库是开源的，并双重许可，受修改后的BSD许可和GPLv2许可的保护。您可以根据自己的选择使用任何一种许可。

tochka-developers / geophp

维护者

详细信息

README

入门

示例用法

更多示例

与 PostGIS 一起工作

致谢