funiq / geophp
一个用于进行几何运算的开源原生PHP库。可以读取和写入多种格式:(E)WKT, (E)WKB, TWKB, GeoJSON, KML, GPX, GeoRSS。支持所有Simple-Feature几何形状(点、线字符串、多边形等),可用于获取质心、边界框、面积等。
Requires
- php: 5.5 - 8.2
Requires (Dev)
- php: 5.5 - 8.3
- php-coveralls/php-coveralls: 2.*
- phpstan/phpstan: ^0.12.18
- phpunit/phpunit: 5.* || 8.*
- squizlabs/php_codesniffer: 3.*
Suggests
- ext-geos: GEOS allows more advanced operations
This package is auto-updated.
Last update: 2024-09-22 16:01:37 UTC
README
GeoPHP是一个用于进行几何运算的开源原生PHP库。它是著名库geoPHP的分支,由Patrick Hayes创建。
它完全用PHP编写,因此可以在共享主机上运行。它可以读取和写入多种格式:WKT (EWKT)、WKB (EWKB)、TWKB、GeoJSON、KML、GPX和GeoRSS。它支持所有Simple-Feature几何形状(点、线字符串、多边形等),并可用来获取质心、边界框、面积以及其他多种有用的信息。
GeoPHP还巧妙地包装了GEOS php扩展,以便当服务器上安装了GEOS时,应用程序可以获得透明性能提升。当安装了GEOS,GeoPHP也完全符合OpenGIS®地理信息实现标准。有了GEOS,您在PHP中获得完整的openGIS功能,如并集、包含、接触等。这意味着应用程序获得了一组在所有环境中都起作用的“核心”几何运算,以及用于已安装GEOS的环境的“扩展”操作集。
下面是“入门”部分,提供了geoPHP能做的一切的参考和示例。
欢迎分支和贡献。请打开问题,发送拉取请求,我会将其合并到主分支。
入门
示例用法
<?php use \geoPHP\geoPHP; // 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->area(); $centroid = $polygon->centroid(); $centX = $centroid->x(); $centY = $centroid->y(); 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 \geoPHP\geoPHP; $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')"); }
文档
进行中…您可以在geophp.net上阅读原始phayes/geoPHP的文档
致谢
- 维护者:Péter Báthory
- 原始作者:Patrick Hayes
其他贡献者
- GeoMemes Research (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
- 艾略特·汉斯顿(文档) https://github.com/ejh
这个库是开源的,并且根据修改后的BSD许可证和GPLv2双重授权。您可以根据自己的选择使用任何一种许可证。