syseleven/powerdnsbundle

This bundle provides (yet another) api for the PowerDns DNS server. It allows the creation and modification of zones and records in the server.

dev-master 2015-11-17 09:32 UTC

Requires

• php: >=5.3.2
• doctrine/common: ~2.5.0
• doctrine/dbal: ~2.5.0
• doctrine/doctrine-bundle: ~1.2
• doctrine/orm: ~2.5.0
• friendsofsymfony/rest-bundle: *
• incenteev/composer-parameter-handler: ~2.0
• jms/serializer-bundle: *
• nelmio/api-doc-bundle: @stable
• psr/log: ~1.0
• sensio/framework-extra-bundle: ~3.0
• symfony/assetic-bundle: ~2.3
• symfony/monolog-bundle: ~2.4
• symfony/swiftmailer-bundle: ~2.3
• symfony/symfony: ~2.7
• twig/extensions: ~1.0
• zendframework/zend-validator: 2.5.*

Requires (Dev)

• doctrine/data-fixtures: 1.x
• doctrine/doctrine-fixtures-bundle: 2.2.x

Conflicts

• jms/serializer: <0.12
• jms/serializer-bundle: <0.11

MIT

• Markus Seifert

• rest
• api
• powerdns
• syseleven

README

This Bundle provides an ReST API for the PowerDNS server written in PHP and integrated in the Symfony framework. It includes methods for creating and maintaining zone and domain records.

Installation

To install you need to include this bundle in your composer.json:

    require: {
         ....
         "syseleven/powerdnsbundle": "dev-master"
    }

Then run `php composer.phar update and activate the Bundle in your kernel and adapt your configuration.

    $bundles = array(
        ...
        new SysEleven\PowerDnsBundle\SysElevenPowerDnsBundle(),
    );

You also need to register JmsSerializer and the FosRestBundle

    $bundles = array(
        ...
        new FOS\RestBundle\FOSRestBundle(),
        new JMS\SerializerBundle\JMSSerializerBundle($this),
    );

The bundle makes some changes to the database structure of PowerDNS but they won't affect the default behaviour.

php app/console doctrine:schema:update --dump-sql -em=<your_entity_manager>

will dump the changes to your current schema, please review them and adapt to your needs.

Configuration

There is not really much configuration for the bundle so far. You can set the entity manager to use with:

sys_eleven_power_dns:
    entity_manager: default

Apart from setting the entity manager, you can also specify default values for new SOA records.

sys_eleven_power_dns:
    entity_manager: default
    soa_defaults:
            primary: ns.domain.com
            hostmaster: [e-mail]
            default_ttl: 3600

Then adapt your routing to load the routes:

syseleven_power_dns:
    resource: "@SysElevenPowerDnsBundle/Resources/config/routing.yml"
    prefix: /

Third Party Bundles

The bundle uses the NelmioApiDocBundle to expose the documentation of the route parameters through its interface if you want to use this feature you have to activate and configure the Bundle. Please refer to the bundles homepage for more information. Integration with the FosRestBundle, the bundle uses the View components of the FosRestBundle, if you have the FosRestBundle in use please check your configuration.

API Documentation

You can find a documentation of the resources and its parameter here.