Source of: /manual/en/internals2.pdo.packaging.php
<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/internals2.pdo.inc";
$setup = array (
'home' =>
array (
0 => 'index.php',
1 => 'PHP Manual',
),
'head' =>
array (
0 => 'UTF-8',
1 => 'en',
),
'this' =>
array (
0 => 'internals2.pdo.packaging.php',
1 => 'Packaging and distribution',
),
'up' =>
array (
0 => 'internals2.pdo.php',
1 => 'PDO Driver How-To',
),
'prev' =>
array (
0 => 'internals2.pdo.testing.php',
1 => 'Testing',
),
'next' =>
array (
0 => 'internals2.pdo.pdo-dbh-t.php',
1 => 'pdo_dbh_t definition',
),
);
$setup["toc"] = $TOC;
$setup["parents"] = $PARENTS;
manual_setup($setup);
manual_header();
?>
<div id="internals2.pdo.packaging" class="sect1">
<h2 class="title">Packaging and distribution</h2>
<div id="internals2.pdo.packaging.creating" class="sect2">
<h3 class="title">Creating a package</h3>
<p class="para">
PDO drivers are released via PECL; all the usual rules for PECL extensions
apply. Packaging is accomplished by creating a valid
<var class="filename">package.xml</var> file and then running:
</p>
<div class="example-contents screen">
<div class="cdata"><pre>
$ pecl package
</pre></div>
</div>
<p class="para">
This will create a tarball named <var class="filename">PDO_SKEL-X.Y.Z.tgz</var>.
</p>
<p class="para">
Before releasing the package, you should test that it builds correctly; if
you've made a mistake in your <var class="filename">config.m4</var> or
<var class="filename">package.xml</var> files, the package may not function
correctly. You can test the build, without installing anything, using the
following invocation:
</p>
<div class="example-contents screen">
<div class="cdata"><pre>
$ pecl build package.xml
</pre></div>
</div>
<p class="para">
Once this is proven to work, you can test installation:
</p>
<div class="example-contents screen">
<div class="cdata"><pre>
$ pecl package
$ sudo pecl install PDO_SKEL-X.Y.X.tgz
</pre></div>
</div>
<p class="para">
Full details about <var class="filename">package.xml</var> can be found in the PEAR
Programmer's documentation (<a href="http://pear.php.net/manual/" class="link external">» http://pear.php.net/manual/</a>).
</p>
</div>
<div id="internals2.pdo.packaging.creating.releasing" class="sect2">
<h3 class="title">Releasing the package</h3>
<p class="para">
A PDO driver is released via the PHP Extension Community Library (PECL).
Information about PECL can be found at <a href="http://pecl.php.net/" class="link external">» http://pecl.php.net/</a>.
</p>
</div>
</div><?php manual_footer(); ?>
