clacy-builders/xml

Clacy Builders XML Express is a library for creating XML documents.

Maintainers

Details

github.com/clacy-builders/xml-express-php

Source

Issues

Installs: 42

Dependents: 2

Suggesters: 0

Security: 0

Stars: 1

Watchers: 2

Forks: 0

Open Issues: 0

0.1 2016-04-08 15:44 UTC

Requires

  • php: >=5.4.0

MIT 86df2c34deeaf5ff8fdeb46ce8b7bd0b0e127c7b

xmlbuilderwriter

This package is not auto-updated.

Last update: 2024-12-21 20:03:23 UTC

README

Installation

XML Express for PHP requires PHP 5.4 or newer.

Add the following to your project's composer.json file:

{
    "minimum-stability": "dev",
    "require": {
        "clacy-builders/xml": "dev-master@dev"
    }
}

Run composer install or composer update.

Without Composer

  1. Download the ZIP file.
  2. Inside your project directory create the directories /vendor/clacy-builders/xml.
  3. From the folder xml-express-php-master inside the ZIP file copy the files it contains into the previously created xml folder.

Replace

require_once 'vendor/autoload.php';

with

require_once 'vendor/clacy-builders/xml/allIncl.php';

Basic Usage

<?php
require_once 'vendor/autoload.php';

use \ClacyBuilders\Xml;

class Kml extends Xml
{
    const MIME_TYPE = 'application/vnd.google-earth.kml+xml';
    const FILENAME_EXTENSION = 'kml';
    const XML_NAMESPACE = 'http://www.opengis.net/kml/2.2';

    public static function createKml()
    {
        return static::createRoot('kml');
    }

    public function placemark($name, $description, $longitude, $latitude, $altitude = 0)
    {
        $pm = $this->append('Placemark');
        $pm->append('name', $name);
        $pm->append('description', $description);
        $pm->append('Point')
                ->append('coordinates', $longitude . ',' . $latitude . ',' . $altitude);
        return $pm;
    }
}

$myKml = Kml::createKml();
$myKml->placemark('Cologne Cathedral',
        'Cologne Cathedral is a Roman Catholic cathedral in Cologne, Germany.',
        '50.9413', '6.958');
$myKml->headerfields('cologne-cathedral');
print $myKml;

The generated markup:

<?xml version="1.0" encoding="UTF-8" ?>
<kml xmlns="http://www.opengis.net/kml/2.2">
    <Placemark>
        <name>Cologne Cathedral</name>
        <description>Cologne Cathedral is a Roman Catholic cathedral in Cologne, Germany.</description>
        <Point>
            <coordinates>50.9413,6.958,0</coordinates>
        </Point>
    </Placemark>
</kml>

The Adhoc trait

Adhoc allows you to use any method name not previously defined to add XML elements or attributes.

<?php
require_once 'vendor/autoload.php';

use \ClacyBuilders\Xml;
use \ClacyBuilders\Adhoc;

class Html extends Xml
{
    use Adhoc;

    const XML_DECLARATION = false;
    const DOCTYPE = '<!DOCTYPE html>';
    const HTML_MODE = true;

    public static function createHtml($lang = null, $manifest = null)
    {
        return static::createRoot('html')
                ->attrib('lang', $lang)
                ->setManifest($manifest);
    }
}

$html = Html::createHtml('en');
$body = $html->body();
$article = $body->article();
$article->h1('Scripting languages');
$article->p(Html::abbr('PHP')->setTitle('PHP: Hypertext Preprocessor') . ' is a
        server-side scripting language designed for web development but also used
        as a general-purpose programming language.');

print $html;

The generated markup:

<!DOCTYPE html>
<html lang="en">
    <body>
        <article>
            <h1>Scripting languages</h1>
            <p><abbr title="PHP: Hypertext Preprocessor">PHP</abbr> is a
            server-side scripting language designed for web development but also used
            as a general-purpose programming language.</p>
        </article>
    </body>
</html>