adding the register node types command even though it currently works only for jackalope - it should be generalized and will tell you so for now

Author: dbu

README.md

@@ -21,12 +21,13 @@ There are a couple of useful commands to interact with a phpcr repository.
 To use the console, make sure you have initialized the git submodules of
 phpcr-utils, then copy cli-config.php.dist to cli-config.php and adjust it
 to your implementation of PHPCR. Then you can run the commands from the
-phpcr-utils directory with ``./bin/phpcr`` 
+phpcr-utils directory with ``./bin/phpcr``
 NOTE: If you are using PHPCR inside of Symfony, the DoctrinePHPCRBundle
 provides the commands inside the normal Symfony console and you don't need to
 prepare anything special.
 
 * ``phpcr:workspace:create <name>``: Create the workspace name in the configured repository
+* ``phpcr:register-node-types --allow-update [cnd-file]``: Register namespaces and node types from a "Compact Node Type Definition" .cnd file
 * ``phpcr:dump [--sys_nodes[="..."]] [--props[="..."]] [path]``: Show the node names
      under the specified path. If you set sys_nodes=yes you will also see system nodes.
      If you set props=yes you will additionally see all properties of the dumped nodes.
@@ -35,8 +36,12 @@ prepare anything special.
 * ``phpcr:sql2``: Run a query in the JCR SQL2 language against the repository and dump
      the resulting rows to the console.
 
-TODO: Implement commands for phpcr:import and phpcr:export to import
-and export the PHPCR document view and system view XML dumps.
+**TODO:**
+
+* Implement commands for phpcr:import and phpcr:export to import and export the
+    PHPCR document view and system view XML dumps.
+* Implement a simple .cnd parser in PHP and use it to make register-node-types
+    work with all repositories
 
 
 ## Helper Classes

bin/phpcr

@@ -36,6 +36,7 @@ $cli->addCommands(array(
     new \PHPCR\Util\Console\Command\CreateWorkspaceCommand(),
     new \PHPCR\Util\Console\Command\DumpCommand(),
     new \PHPCR\Util\Console\Command\PurgeCommand(),
+    new \PHPCR\Util\Console\Command\RegisterNodeTypesCommand(),
     new \PHPCR\Util\Console\Command\Sql2Command(),
 ));
 $cli->run();

src/PHPCR/Util/Console/Command/RegisterNodeTypesCommand.php

@@ -0,0 +1,89 @@
+<?php
+
+namespace PHPCR\Util\Console\Command;
+
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+
+/**
+ * Command to load and register a node type defined in a CND file.
+ *
+ * See the link below for the cnd definition.
+ * @link http://jackrabbit.apache.org/node-type-notation.html
+ *
+ * @author Uwe Jäger <uwej711@googlemail.com>
+ */
+class RegisterNodeTypesCommand extends Command
+{
+   /**
+     * @see Command
+     */
+    protected function configure()
+    {
+        $this
+        ->setName('phpcr:register-node-types')
+        ->setDescription('Register node types in the PHPCR repository')
+        ->setDefinition(array(
+            new InputArgument(
+                'cnd-file', InputArgument::REQUIRED, 'Register namespaces and node types from a "Compact Node Type Definition" .cnd file'
+            ),
+            new InputOption('allow-update', '', InputOption::VALUE_NONE, 'Overwrite existig node type'),
+        ))
+        ->setHelp(<<<EOT
+Register node types in the PHPCR repository.
+
+This command allows to register node types in the repository that are defined
+in a CND (Compact Namespace and Node Type Definition) file as used by jackrabbit.
+
+Custom node types can be used to define the structure of content repository
+nodes, like allowed properties and child nodes together with the namespaces
+and their prefix used for the names of node types and properties.
+
+If you use --allow-update existing node type definitions will be overwritten
+in the repository.
+EOT
+        );
+    }
+
+   /**
+     * @see Command
+     */
+    protected function execute(InputInterface $input, OutputInterface $output)
+    {
+        $cnd_file = realpath($input->getArgument('cnd-file'));
+
+        if (!file_exists($cnd_file)) {
+            throw new \InvalidArgumentException(
+                sprintf("Node type definition file '<info>%s</info>' does not exist.", $cnd_file)
+            );
+        } elseif (!is_readable($cnd_file)) {
+            throw new \InvalidArgumentException(
+                sprintf("Node type definition file '<info>%s</info>' does not have read permissions.", $cnd_file)
+            );
+        }
+
+        $cnd = file_get_contents($cnd_file);
+        $allowUpdate = $input->getOption('allow-update');
+
+        $session = $this->getHelper('phpcr')->getSession();
+        if (! $session instanceof \Jackalope\Session) {
+            throw new \Exception('PHPCR only provides an API to register node types. Your implementation is not Jackalope (which provides a method for .cnd). TODO: parse the file and do the necessary API calls');
+        }
+        $ntm = $session->getWorkspace()->getNodeTypeManager();
+
+        try {
+            $ntm->registerNodeTypesCnd($cnd, $allowUpdate);
+        } catch (\PHPCR\NodeType\NodeTypeExistsException $e) {
+            if (!$allowUpdate) {
+                $output->write(PHP_EOL.'<error>The node type(s) you tried to register already exist.</error>'.PHP_EOL);
+                $output->write(PHP_EOL.'If you want to override the existing definition call this command with the ');
+                $output->write('<info>--allow-update</info> option.'.PHP_EOL);
+            }
+            throw $e;
+        }
+        $output->write(PHP_EOL.sprintf('Successfully registered node types from "<info>%s</info>"', $cnd_file) . PHP_EOL);
+    }
+}