hfelge/geoserver-client

Ein moderner PHP-Client zur einfachen Kommunikation mit der GeoServer REST-API.

v1.8.0 2025-05-22 19:31 UTC

Requires

• php: ^8.3

Requires (Dev)

• phpunit/phpunit: ^12.1.0

MIT

• Henry Felgner

README

A modern, lightweight PHP client for interacting with the GeoServer REST API (REST, SLD Upload, and Security Management).

Features

• Manage GeoServer Workspaces (get, exists, create, update, delete)
• Manage GeoServer Datastores (get, exists, createPostGIS, update, delete)
• Manage GeoServer FeatureTypes (get, exists, create, update, delete)
• Manage GeoServer Layers (get, exists, publish, update, delete)
• Manage GeoServer Styles:
  • createWorkspaceStyle() (SLD upload via Slug)
  • assignStyleToLayer()
  • updateStyle(), deleteStyle(), styleExists()
• Manage GeoServer Users:
  • getUsers(), getUser(), createUser(), updateUserStatus(), deleteUser()
• Robust error handling with GeoServerException
• GeoServer availability check via isAvailable()
• 100% PHPUnit 12 test coverage
• PSR-4 ready and composer-installable

Installation

Install via Composer:

composer require hfelge/geoserver-client

Usage Example

<?php

use Hfelge\GeoServerClient\GeoServerClient;

$client = new GeoServerClient('http://localhost:8080/geoserver', 'admin', 'geoserver');

// === WORKSPACES ===
if (!$client->workspaceManager->workspaceExists('example_ws')) {
    $client->workspaceManager->createWorkspace('example_ws');
}

// === DATASTORES ===
if (!$client->datastoreManager->datastoreExists('example_ws', 'example_ds')) {
    $client->datastoreManager->createPostGISDatastore('example_ws', 'example_ds', [
        'host'     => 'localhost',
        'port'     => '5432',
        'database' => 'gis',
        'user'     => 'geo_user',
        'passwd'   => 'secret',
    ]);
}

// === FEATURETYPES ===
if (!$client->featureTypeManager->featureTypeExists('example_ws', 'example_ds', 'stadtgrenzen')) {
    $client->featureTypeManager->createFeatureType('example_ws', 'example_ds', [
        'name'       => 'stadtgrenzen',
        'nativeName' => 'stadtgrenzen',
        'title'      => 'Stadtgrenzen',
        'srs'        => 'EPSG:4326',
    ]);
}

// === LAYERS ===
if (!$client->layerManager->layerExists('stadtgrenzen')) {
    $client->layerManager->publishLayer('stadtgrenzen');
}

// === STYLES ===
$sld = file_get_contents(__DIR__ . '/style.sld');
$client->styleManager->createWorkspaceStyle('example_ws', 'my_custom_style', $sld);
$client->styleManager->assignStyleToLayer('stadtgrenzen', 'my_custom_style');

// === USERS ===
$client->userManager->createUser('demo_user', 'secure123');
$users = $client->userManager->getUsers();
$client->userManager->updateUserStatus('demo_user', false); // disable user
$client->userManager->deleteUser('demo_user');

Requirements

• PHP 8.3 or higher
• GeoServer instance with REST API access
• Optional: Docker/DDEV setup for local testing

Project Structure

src/    → Contains the core library
tests/  → Contains PHPUnit tests

Development

Run PHPUnit tests:

vendor/bin/phpunit

License

This project is licensed under the MIT License - see the LICENSE file for details.