Download the PHP package wgirhad/geophp without Composer

GeoPHP is a open-source native PHP library for doing geometry operations. It is a fork of famous geoPHP library by Patrick Hayes.

Notice about this repo

This fork aims to unify the most relevant forks from the original work of phayes/geoPHP

Goals

• Maintain compatibility with current supported versions of PHP
• Keep the unit tests compatible with the latest PHPUnit
• Merge contributions from other geoPHP forks, like funiq, swen100 and others

It is written entirely in PHP and can therefore run on shared hosts. It can read and write a wide variety of formats: WKT (EWKT), WKB (EWKB), TWKB, GeoJSON, KML, GPX, and GeoRSS. It works with all Simple-Feature geometries (Point, LineString, Polygon, GeometryCollection etc.) and can be used to get centroids, bounding-boxes, area, and a wide variety of other useful information.

GeoPHP also helpfully wraps the GEOS php extension so that applications can get a transparent performance increase when GEOS is installed on the server. When GEOS is installed, geoPHP also becomes fully compliant with the OpenGIS® Implementation Standard for Geographic information. With GEOS you get the full-set of openGIS functions in PHP like Union, IsWithin, Touches etc. This means that applications get a useful "core-set" of geometry operations that work in all environments, and an "extended-set"of operations for environments that have GEOS installed.

See the getting started section below for references and examples of everything that geoPHP can do.

Forks and contributions are welcome. Please open issues, send pull requests and I will merge them into the main branch.

Getting Started

Example usage

More Examples

The Well Known Text (WKT) and Well Known Binary (WKB) support is ideal for integrating with MySQL's or PostGIS's spatial capability. Once you have SELECTed your data with 'AsText('geo_field')' or 'AsBinary('geo_field')', you can put it straight into geoPHP (can be wkt or wkb, but must be the same as how you extracted it from your database):

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

You can collect multiple geometries into one (note that you must use wkt for this):

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

Calling get components returns the sub-geometries within a geometry as an array.

$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'

An alternative is to use the asArray() method. Using the above geometry collection of two linestrings,

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

Clearly, more complex analysis is possible.

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

Working with PostGIS

geoPHP, through it's EWKB adapter, has good integration with postGIS. Here's an example of reading and writing postGIS geometries

Documentation

In progress… You can read the doc for original phayes/geoPHP at geophp.net

Credit

• Maintainer: Péter Báthory
• Original author: Patrick Hayes

Additional Contributors:

• GeoMemes Research (http://www.geomemes.com)
• HighWire Press (http://www.highwire.org) and GeoScienceWorld (http://www.geoscienceworld.org)
• Arnaud Renevier (gisconverter.php) https://github.com/arenevier/gisconverter.php
• Dave Tarc https://github.com/dtarc
• Elliott Hunston (documentation) https://github.com/ejh

This library is open-source and dual-licensed under both the Modified BSD License and GPLv2. Either license may be used at your option.