Doctrine-PostGIS 项目使用教程

Doctrine-PostGIS 项目使用教程

doctrine-postgisSpatial and Geographic Data with PostGIS and Doctrine.项目地址:https://gitcode.com/gh_mirrors/do/doctrine-postgis

1. 项目的目录结构及介绍

Doctrine-PostGIS 是一个用于处理空间和地理数据的库，结合了 PostGIS 和 Doctrine ORM。以下是项目的目录结构及其介绍：

doctrine-postgis/
├── src/
│   ├── Event/
│   │   ├── ORMSchemaEventSubscriber.php
│   │   ├── DBALSchemaEventSubscriber.php
│   ├── Functions/
│   │   ├── ST_Within.php
│   │   ├── ST_Distance.php
│   │   └── ...
│   ├── Types/
│   │   ├── PostGISType.php
│   └── Configurator.php
├── tests/
│   ├── bootstrap.php
│   ├── ORM/
│   ├── DBAL/
│   └── ...
├── composer.json
├── README.md
└── ...

• src/: 包含库的主要源代码。
  • Event/: 包含事件订阅器，用于处理 ORM 和 DBAL 的架构事件。
  • Functions/: 包含 PostGIS 函数的实现。
  • Types/: 包含自定义的 PostGIS 类型。
  • Configurator.php: 用于注册所有函数的便捷类。
• tests/: 包含测试代码。
• composer.json: Composer 配置文件。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

Doctrine-PostGIS 项目的启动文件主要是 Configurator.php 和事件订阅器文件。以下是启动文件的介绍：

Configurator.php

Configurator.php 文件位于 src/ 目录下，用于注册所有 PostGIS 函数。示例如下：

use Doctrine\ORM\Configuration;
use Jsor\Doctrine\PostGIS\Configurator;

$configuration = new Configuration();
$configurator = new Configurator();
$configurator->configure($configuration);

事件订阅器

事件订阅器文件位于 src/Event/ 目录下，包括 ORMSchemaEventSubscriber.php 和 DBALSchemaEventSubscriber.php。这些文件用于在 ORM 和 DBAL 中处理架构事件。

use Jsor\Doctrine\PostGIS\Event\ORMSchemaEventSubscriber;
use Jsor\Doctrine\PostGIS\Event\DBALSchemaEventSubscriber;

$entityManager->getEventManager()->addEventSubscriber(new ORMSchemaEventSubscriber());
$connection->getEventManager()->addEventSubscriber(new DBALSchemaEventSubscriber());

3. 项目的配置文件介绍

项目的配置文件主要是 composer.json 和 README.md。

composer.json

composer.json 文件用于定义项目的依赖关系和其他配置。以下是部分内容：

{
    "name": "jsor/doctrine-postgis",
    "description": "Spatial and Geographic Data with PostGIS and Doctrine",
    "require": {
        "doctrine/orm": "^2.9",
        "doctrine/dbal": "^2.13 || ^3.1",
        "php": ">=7.4"
    },
    "autoload": {
        "psr-4": {
            "Jsor\\Doctrine\\PostGIS\\": "src/"
        }
    }
}

README.md

README.md 文件提供了项目的详细说明，包括安装、配置和使用方法。以下是部分内容：

# Doctrine-PostGIS

## Installation

Install the latest version with Composer:

```bash
composer require jsor/doctrine-postgis

Setup

To use the library with the Doctrine ORM, register the ORMSchemaEventSubscriber event subscriber:

use Jsor\Doctrine\PostGIS\Event\ORMSchemaEventSubscriber;

$entityManager->getEventManager()->addEventSubscriber(new ORMSchemaEventSubscriber());

To use it with the DBAL only, register the DBALSchemaEventSubscriber event subscriber:

use Jsor\Doctrine\PostGIS\Event\DBALSchemaEventSubscriber;

$connection->getEventManager()->addEventSubscriber(new DBALSchemaEventSubscriber());

以上是 Doctrine-PostGIS 项目的目录结构、启动文件和配置文件的介绍。希望这份教程能帮助你更好地理解和使用该项目。

doctrine-postgisSpatial and Geographic Data with PostGIS and Doctrine.项目地址:https://gitcode.com/gh_mirrors/do/doctrine-postgis