* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/php: php-guide.xml
@ 2010-04-23 23:42 Matti Bickel (mabi)
0 siblings, 0 replies; 4+ messages in thread
From: Matti Bickel (mabi) @ 2010-04-23 23:42 UTC (permalink / raw
To: gentoo-commits
mabi 10/04/23 23:42:19
Added: php-guide.xml
Log:
first raw cut version of the php guide
Revision Changes Path
1.1 xml/htdocs/proj/en/php/php-guide.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/php/php-guide.xml?rev=1.1&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/php/php-guide.xml?rev=1.1&content-type=text/plain
Index: php-guide.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/php/php-guide.xml,v 1.1 2010/04/23 23:42:19 mabi Exp $ -->
<guide link="php-guide.xml" lang="en">
<title>Upgrading PHP</title>
<author title="Author">
<mail link="akorthaus@web.de">Andreas Korthaus</mail>
<mail link="mabi@gentoo.org">Matti Bickel</mail>
</author>
<abstract>
This document describes how PHP is set up in Gentoo.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>1.0</version>
<date>2010-04-22</date>
<chapter>
<title>PHP package</title>
<section>
<title>Basic PHP Packages Consolidated</title>
<body>
<p>
There is only one php package (as opposed to one package for each SAPI like
cgi, cli or apache). You can enable the SAPIs you want via USE flags in
<c>dev-lang/php</c>. A list of available SAPIs is included below.
You can combine them as you wish, but obviously you need at least one of
them to make any use of your php installation.
</p>
<p>
To choose the SAPI you want, use these USE flags:
</p>
<ul>
<li><c>cgi</c> - builds & installs <path>/usr/bin/php-cgi</path></li>
<li><c>cli</c> - builds & installs <path>/usr/bin/php</path></li>
<li><c>apache2</c> - builds & installs <c>mod_php</c> for Apache 2.0</li>
</ul>
<note>
There are requests to add <c>fpm</c> as a SAPI. The Gentoo PHP team will
support this as soon as the PHP project includes this SAPI in an upstream
release of php (most likely php-5.4).
</note>
</body>
</section>
<section>
<title>Portage Categories</title>
<body>
<p>
The PHP package have been moved from <c>dev-php</c> to <c>dev-lang/php</c>.
You can find PECL extensions and other packages depending on the version of PHP
in the <c>dev-php5</c> category. All version independent packages can be found
in the <c>dev-php</c> category. This was introduced to support the parallel use
of PHP4 and PHP5 and will continue with a <c>dev-php6</c> category once the PHP
project releases a new major version.
</p>
</body>
</section>
<section>
<title>Directories and configuration files</title>
<body>
<ul>
<li>The PHP package installs its contents into <path>/usr/lib/php5</path>
(the Apache modules go into the right place for Apache).</li>
<li>The PEAR packages and other PHP libraries go into <path>/usr/share/php</path> (was
<path>/usr/lib/php</path> before).</li>
<li>PECL packages will no longer add configuration directives by adding them
to the <path>php.ini</path> configuration file, but add a
<path>[PACKAGE].ini</path> file to the <path>/etc/php/[SAPI]/ext</path>
directory.</li>
</ul>
</body>
</section>
<section>
<title>Symlinking of PHP binaries</title>
<body>
<p> The PHP package will create symlinks in <path>/usr/bin</path> for the
version of PHP you installed most recently. Currently, your choice is
restricted to PHP major version 5. However, the Gentoo PHP team may
allow a more fine grained slotting or introduce PHP6 to the tree. You
can then <uri link="#doc_chap3_sect5">use the php-select tool</uri>
from <c>app-admin/php-toolkit</c> to change the symlinks. </p>
</body>
</section>
</chapter>
<chapter>
<title>Configuration</title>
<section>
<title>USE flags</title>
<body>
<p>
For a list of recommended USE flags look at <uri
link="http://overlays.gentoo.org/proj/php/wiki/CommonQuestions">
Recommend USE flags</uri>. For a list of USE flags available for
PHP have a look at the <uri
link="http://overlays.gentoo.org/proj/php/wiki/NewUseFlags">USE
flags table</uri> from overlay wiki.
</p>
</body>
</section>
<section>
<title>Configuration files</title>
<body>
<p>
The Gentoo PHP Package stores configuration in <path>/etc/php</path>, which
contains one subdirectory for each SAPI for each PHP version (only PHP5 for
now):
</p>
<pre caption="list PHP config directories">
$ <i>ls -1 /etc/php</i>
apache2-php5
cli-php5
cgi-php5
</pre>
<p> Every subdirectory contains an own <path>php.ini</path>, but external
(shared) extension are now kept in their own
<path>/etc/php/{apach2,cli,cgi}-php5/ext</path> directory. To enable/
disable shared extensions, symlinks from <path>/etc/php/*/ext-active</path>
are used. If you want to enable an extension, create a symlink in
<path>/etc/php/*/ext-active</path> to the corresponding
<path>[EXTENSION].ini</path> file in <path>/etc/php/*/ext/</path>. If you
want to disable an extension, remove the symlink. </p>
<note> If you install PHP as an Apache module, make sure to restart Apache
after installation and configuration. </note>
</body>
</section>
<section>
<title>Configure Apache to work with PHP5</title>
<body>
<p> To configure Apache to load your PHP5 module (mod_php), you have to add
<c>-D PHP5</c> to <c>APACHE2_OPTS</c> variable in
<path>/etc/conf.d/apache2</path>. </p>
<pre caption="Configure Apache to load mod_php">
<comment>(settings for PHP5)</comment>
<i>APACHE2_OPTS="-D PHP5"</i>
</pre>
<note>You can not use two different PHP modules with Apache at the same time.</note>
</body>
</section>
</chapter>
<chapter>
<title>Support / Getting Help</title>
<section>
<body>
<p> If you run into problems with the new Gentoo PHP packages, here's where you
can get help: </p>
<ul>
<li>
<uri link="http://overlays.gentoo.org/proj/php/wiki/CommonQuestions">Common
Questions</uri> about PHP on Gentoo
</li>
<li>
<uri link="http://overlays.gentoo.org/proj/php/">Development-Page of the PHP
Overlay</uri>
</li>
<li>
#gentoo-php on irc.freenode.net; this is the chatroom where the overlay's
regular authors hang out. We'd love to see you there!
</li>
<li>
<uri link="http://forums.gentoo.org/">Gentoo Forums</uri> are a popular
place to ask for help. There are plenty of other Gentoo users reading the
Forums round the clock, making it a great place to get help in a hurry.
</li>
</ul>
<p> On the <uri link="http://overlays.gentoo.org/proj/php/">Development-Page</uri>
you'll find a lot of documentation and <uri
link="http://git.overlays.gentoo.org/gitweb/?p=proj/php.git">our git
repository</uri> provides a test ground for packages, which will be moved
to the official Portage tree later. </p>
</body>
</section>
</chapter>
</guide>
^ permalink raw reply [flat|nested] 4+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/php: php-guide.xml
@ 2010-11-20 14:52 Matti Bickel (mabi)
0 siblings, 0 replies; 4+ messages in thread
From: Matti Bickel (mabi) @ 2010-11-20 14:52 UTC (permalink / raw
To: gentoo-commits
mabi 10/11/20 14:52:08
Modified: php-guide.xml
Log:
update guide to minor version slotting
Revision Changes Path
1.2 xml/htdocs/proj/en/php/php-guide.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/php/php-guide.xml?rev=1.2&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/php/php-guide.xml?rev=1.2&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/php/php-guide.xml?r1=1.1&r2=1.2
Index: php-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/php/php-guide.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- php-guide.xml 23 Apr 2010 23:42:19 -0000 1.1
+++ php-guide.xml 20 Nov 2010 14:52:08 -0000 1.2
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/php/php-guide.xml,v 1.1 2010/04/23 23:42:19 mabi Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/php/php-guide.xml,v 1.2 2010/11/20 14:52:08 mabi Exp $ -->
<guide link="php-guide.xml" lang="en">
<title>Upgrading PHP</title>
@@ -8,6 +8,7 @@
<author title="Author">
<mail link="akorthaus@web.de">Andreas Korthaus</mail>
<mail link="mabi@gentoo.org">Matti Bickel</mail>
+ <mail link="olemarkus@gentoo.org">Ole Markus With</mail>
</author>
<abstract>
@@ -19,21 +20,22 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.0</version>
-<date>2010-04-22</date>
+<version>1.4</version>
+<date>2010-11-16</date>
<chapter>
<title>PHP package</title>
<section>
<title>Basic PHP Packages Consolidated</title>
+
<body>
<p>
- There is only one php package (as opposed to one package for each SAPI like
- cgi, cli or apache). You can enable the SAPIs you want via USE flags in
- <c>dev-lang/php</c>. A list of available SAPIs is included below.
- You can combine them as you wish, but obviously you need at least one of
- them to make any use of your php installation.
+There is only one php package (as opposed to one package for each SAPI like
+cgi, cli or apache). You can enable the SAPIs you want via USE flags in
+<c>dev-lang/php</c>. A list of available SAPIs is included below.
+You can combine them as you wish, but obviously you need at least one of
+them to make any use of your php installation.
</p>
<p>
@@ -41,96 +43,151 @@
</p>
<ul>
- <li><c>cgi</c> - builds & installs <path>/usr/bin/php-cgi</path></li>
- <li><c>cli</c> - builds & installs <path>/usr/bin/php</path></li>
- <li><c>apache2</c> - builds & installs <c>mod_php</c> for Apache 2.0</li>
+
+<li><c>cgi</c> - builds & installs <path>/usr/bin/php-cgi</path></li>
+<li><c>cli</c> - builds & installs <path>/usr/bin/php</path></li>
+<li><c>apache2</c> - builds & installs <c>mod_php</c> for Apache 2</li>
+<li><c>fpm</c> - builds & installs the PHP FastCgi Process Manager (only available in PHP-5.3 and newer)</li>
+<li><c>embed</c> - builds & installs the embedded PHP client</li>
+
</ul>
-<note>
- There are requests to add <c>fpm</c> as a SAPI. The Gentoo PHP team will
- support this as soon as the PHP project includes this SAPI in an upstream
- release of php (most likely php-5.4).
-</note>
-
</body>
</section>
+</chapter>
+
+<chapter>
+<title>Slotting</title>
<section>
-<title>Portage Categories</title>
-<body>
+<title>Minor version slotting</title>
-<p>
-The PHP package have been moved from <c>dev-php</c> to <c>dev-lang/php</c>.
-You can find PECL extensions and other packages depending on the version of PHP
-in the <c>dev-php5</c> category. All version independent packages can be found
-in the <c>dev-php</c> category. This was introduced to support the parallel use
-of PHP4 and PHP5 and will continue with a <c>dev-php6</c> category once the PHP
-project releases a new major version.
-</p>
+<body><p>
+The php team decided to ease the transition between PHP-5.2 and PHP-5.3 by
+allowing users to install both versions concurrently. Using the cgi or FPM
+SAPI, you can even serve web pages utilizing PHP-5.2 and PHP-5.3 (or PHP-5.4
+once it's released) at the same time. </p>
+
+<p> For implementing minor version slotting, we chose an approach similar to
+that of the ruby team --- you can set a global variable <c>PHP_TARGETS</c> to
+control which slots you want and manage the active version via an eselect
+module (see <uri link="#doc_chap3">chapter 3</uri>) </p></body>
-</body>
</section>
+</chapter>
+
+<chapter>
+<title>Switching from major to minor version slotting</title>
<section>
-<title>Directories and configuration files</title>
-<body>
+<title>Removing the old installation</title>
-<ul>
- <li>The PHP package installs its contents into <path>/usr/lib/php5</path>
- (the Apache modules go into the right place for Apache).</li>
- <li>The PEAR packages and other PHP libraries go into <path>/usr/share/php</path> (was
- <path>/usr/lib/php</path> before).</li>
- <li>PECL packages will no longer add configuration directives by adding them
- to the <path>php.ini</path> configuration file, but add a
- <path>[PACKAGE].ini</path> file to the <path>/etc/php/[SAPI]/ext</path>
- directory.</li>
-</ul>
+<body><p> You need to deinstall <c>dev-lang/php</c> and
+<c>app-admin/php-toolkit</c>, if you have them installed: </p>
+
+<pre caption="Uninstalling your php setup">
+<i>emerge -C php php-toolkit</i>
+</pre>
+
+<note>If you always want PHP extensions compiled for all installed PHP versions,
+you can skip the next step.</note>
+
+<p>Decide which versions of PHP you want extensions compiled for and set them
+in your <path>/etc/make.conf</path>. </p>
+
+<pre caption="Setting PHP_TARGETS in /etc/make.conf">
+<comment># Run PHP 5.3 and PHP 5.2 in parallel</comment>
+<var>PHP_TARGETS="php5-3 php5-2"</var>
+</pre>
+
+<p> You can set the targets in any order. Note that the php slot is named "5.3"
+and the corresponding <c>PHP_TARGETS</c> setting is <c>php5-3</c>. This is due
+to current restrictions on USE names.<br /> You can also set <c>PHP_TARGETS</c>
+per package like so: </p>
+
+<pre caption="Setting PHP_TARGETS in package.use">
+<comment>; compile mailparse only for php-5.3</comment>
+dev-php5/mailparse php_targets_php5-3
+</pre>
+
+<p>Next, install the PHP versions you want: </p>
+
+<pre caption="Installing both PHP-5.2 and -5.3">
+emerge =dev-lang/php:5.2 =dev-lang/php:5.3
+</pre>
+
+<p> Note that using <c>emerge php</c> is enough to always get the latest stable
+version. </p>
+
+<p>Update your extensions. If you have installed PHP extensions such as suhosin
+or mailparse, you need to reinstall them.<br /> The php team has provided a
+minor version slotting compatible version of every package in the
+<c>dev-php5</c> category. They currently have testing keywords only, so you
+might need to add them to your <path>/etc/portage/package.keywords</path> file,
+if you are running an otherwise stable system. </p>
+
+<pre caption="Reinstalling all extensions">
+emerge -av $(equery depends dev-lang/php | egrep -v 'dev-php/|/php' | sed -e 's:^:=:')
+</pre>
+
+<p> Note that <c>PHP_TARGETS</c> is displayed as a USE-expand variable.<br />
+Some extensions are not available for all slots (e.g. have not been updated to
+work with PHP-5.3). They will indicate this via the <c>USE_PHP</c> variable
+like this: </p>
+
+<pre caption="Ebuild for an extension that supports PHP-5.2 only">
+EAPI=2
+USE_PHP="php5-2" # default would be "php5-2 php5-3"
+
+inherit php-ext-source-r2
+[...]
+</pre>
</body>
</section>
+</chapter>
+<chapter>
+<title>Minor version slotting in detail</title>
<section>
<title>Symlinking of PHP binaries</title>
-<body>
- <p> The PHP package will create symlinks in <path>/usr/bin</path> for the
- version of PHP you installed most recently. Currently, your choice is
- restricted to PHP major version 5. However, the Gentoo PHP team may
- allow a more fine grained slotting or introduce PHP6 to the tree. You
- can then <uri link="#doc_chap3_sect5">use the php-select tool</uri>
- from <c>app-admin/php-toolkit</c> to change the symlinks. </p>
+<body><p>
+The first time you install a minor version slotted PHP, the new eselect php
+module is automatically called to set symlinks in <path>/usr/bin</path> to the
+PHP binaries in <path>/usr/lib/php5.3/bin</path> (assuming you installed
+php-5.3 first). There is one symlink for each fpm, cgi or cli SAPI you enabled
+via USE flags. Additionally, a symlink to the apache module in
+<path>/usr/lib/php5.3/apache2/</path> is placed in your apache module directory
+if you installed php with USE="apache2". </p>
+
+<p>Ole Markus With kindly provided an eselect module
+(<c>app-admin/eselect-php</c>) to manage the symlinks. You can list and update
+the active PHP version for each SAPI seperatly. Here is an example using the
+apache2 SAPI:
+</p>
-</body>
-</section>
-</chapter>
+<pre caption="Using the PHP eselect module when you have PHP-5.2 and 5.3 installed">
+# <i>eselect php list apache2</i>
+[1] php5.2
+[2] php5.3 *
+# <i>eselect php set apache2 1</i>
+You have to run `/etc/init.d/apache2 restart' for the changes to take effect
+</pre>
-<chapter>
-<title>Configuration</title>
+<p> The eselect module currently supports fpm, apache2, cli and cgi SAPIs </p></body>
-<section>
-<title>USE flags</title>
-<body>
- <p>
- For a list of recommended USE flags look at <uri
- link="http://overlays.gentoo.org/proj/php/wiki/CommonQuestions">
- Recommend USE flags</uri>. For a list of USE flags available for
- PHP have a look at the <uri
- link="http://overlays.gentoo.org/proj/php/wiki/NewUseFlags">USE
- flags table</uri> from overlay wiki.
- </p>
-</body>
</section>
<section>
<title>Configuration files</title>
-<body>
-<p>
+<body><p>
The Gentoo PHP Package stores configuration in <path>/etc/php</path>, which
-contains one subdirectory for each SAPI for each PHP version (only PHP5 for
-now):
-</p>
+contains one subdirectory for each SAPI for each PHP version, e.g.
+configuration files for the PHP-5.3 apache2 SAPI are installed in
+<path>/etc/php/apache2-php5.3</path> </p>
<pre caption="list PHP config directories">
$ <i>ls -1 /etc/php</i>
@@ -139,28 +196,28 @@
cgi-php5
</pre>
-<p> Every subdirectory contains an own <path>php.ini</path>, but external
- (shared) extension are now kept in their own
- <path>/etc/php/{apach2,cli,cgi}-php5/ext</path> directory. To enable/
- disable shared extensions, symlinks from <path>/etc/php/*/ext-active</path>
- are used. If you want to enable an extension, create a symlink in
- <path>/etc/php/*/ext-active</path> to the corresponding
- <path>[EXTENSION].ini</path> file in <path>/etc/php/*/ext/</path>. If you
- want to disable an extension, remove the symlink. </p>
+<p>Every subdirectory contains an own <path>php.ini</path>, but external
+(shared) extension are now kept in their own
+<path>/etc/php/&sapi>-&slot>/ext</path> directory. To enable/ disable
+shared extensions, symlinks from <path>/etc/php/*/ext-active</path> are used.
+If you want to enable an extension, create a symlink in
+<path>/etc/php/*/ext-active</path> to the corresponding
+<path>&extension>.ini</path> file in <path>/etc/php/*/ext/</path>. If you
+want to disable an extension, remove the symlink. </p>
<note> If you install PHP as an Apache module, make sure to restart Apache
- after installation and configuration. </note>
+after installation and configuration. </note>
</body>
</section>
<section>
<title>Configure Apache to work with PHP5</title>
-<body>
- <p> To configure Apache to load your PHP5 module (mod_php), you have to add
- <c>-D PHP5</c> to <c>APACHE2_OPTS</c> variable in
- <path>/etc/conf.d/apache2</path>. </p>
+<body><p>
+To configure Apache to load your PHP5 module (mod_php), you have to add <c>-D
+PHP5</c> to <c>APACHE2_OPTS</c> variable in <path>/etc/conf.d/apache2</path>.
+</p>
<pre caption="Configure Apache to load mod_php">
<comment>(settings for PHP5)</comment>
@@ -173,39 +230,41 @@
</section>
</chapter>
+
<chapter>
<title>Support / Getting Help</title>
<section>
-<body>
-<p> If you run into problems with the new Gentoo PHP packages, here's where you
- can get help: </p>
+<body><p>
+If you run into problems with the new Gentoo PHP packages, here's where you
+can get help:
+</p>
<ul>
- <li>
- <uri link="http://overlays.gentoo.org/proj/php/wiki/CommonQuestions">Common
- Questions</uri> about PHP on Gentoo
- </li>
- <li>
- <uri link="http://overlays.gentoo.org/proj/php/">Development-Page of the PHP
- Overlay</uri>
- </li>
- <li>
- #gentoo-php on irc.freenode.net; this is the chatroom where the overlay's
- regular authors hang out. We'd love to see you there!
- </li>
- <li>
- <uri link="http://forums.gentoo.org/">Gentoo Forums</uri> are a popular
- place to ask for help. There are plenty of other Gentoo users reading the
- Forums round the clock, making it a great place to get help in a hurry.
- </li>
+<li>
+<uri link="http://overlays.gentoo.org/proj/php/wiki/CommonQuestions">Common
+Questions</uri> about PHP on Gentoo
+</li>
+<li>
+<uri link="http://overlays.gentoo.org/proj/php/">Development-Page of the PHP
+Overlay</uri>
+</li>
+<li>
+#gentoo-php on irc.freenode.net; this is the chatroom where the overlay's
+regular authors hang out. We'd love to see you there!
+</li>
+<li>
+<uri link="http://forums.gentoo.org/">Gentoo Forums</uri> are a popular
+place to ask for help. There are plenty of other Gentoo users reading the
+Forums round the clock, making it a great place to get help in a hurry.
+</li>
</ul>
<p> On the <uri link="http://overlays.gentoo.org/proj/php/">Development-Page</uri>
- you'll find a lot of documentation and <uri
- link="http://git.overlays.gentoo.org/gitweb/?p=proj/php.git">our git
- repository</uri> provides a test ground for packages, which will be moved
- to the official Portage tree later. </p>
+you'll find a lot of documentation and <uri
+link="http://git.overlays.gentoo.org/gitweb/?p=proj/php.git">our git
+repository</uri> provides a test ground for packages, which will be moved
+to the official Portage tree later. </p>
</body>
</section>
^ permalink raw reply [flat|nested] 4+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/php: php-guide.xml
@ 2010-12-27 22:06 Jeremy Olexa (darkside)
0 siblings, 0 replies; 4+ messages in thread
From: Jeremy Olexa (darkside) @ 2010-12-27 22:06 UTC (permalink / raw
To: gentoo-commits
darkside 10/12/27 22:06:16
Modified: php-guide.xml
Log:
Fix atom syntax, bug 347792 by John Feuerstein
Revision Changes Path
1.3 xml/htdocs/proj/en/php/php-guide.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/php/php-guide.xml?rev=1.3&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/php/php-guide.xml?rev=1.3&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/php/php-guide.xml?r1=1.2&r2=1.3
Index: php-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/php/php-guide.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- php-guide.xml 20 Nov 2010 14:52:08 -0000 1.2
+++ php-guide.xml 27 Dec 2010 22:06:16 -0000 1.3
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/php/php-guide.xml,v 1.2 2010/11/20 14:52:08 mabi Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/php/php-guide.xml,v 1.3 2010/12/27 22:06:16 darkside Exp $ -->
<guide link="php-guide.xml" lang="en">
<title>Upgrading PHP</title>
@@ -20,8 +20,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.4</version>
-<date>2010-11-16</date>
+<version>1.5</version>
+<date>2010-12-27</date>
<chapter>
<title>PHP package</title>
@@ -113,7 +113,7 @@
<p>Next, install the PHP versions you want: </p>
<pre caption="Installing both PHP-5.2 and -5.3">
-emerge =dev-lang/php:5.2 =dev-lang/php:5.3
+emerge dev-lang/php:5.2 dev-lang/php:5.3
</pre>
<p> Note that using <c>emerge php</c> is enough to always get the latest stable
^ permalink raw reply [flat|nested] 4+ messages in thread
* [gentoo-commits] gentoo commit in xml/htdocs/proj/en/php: php-guide.xml
@ 2011-01-05 12:15 Matti Bickel (mabi)
0 siblings, 0 replies; 4+ messages in thread
From: Matti Bickel (mabi) @ 2011-01-05 12:15 UTC (permalink / raw
To: gentoo-commits
mabi 11/01/05 12:15:50
Modified: php-guide.xml
Log:
add a note about unsupported USE combinations, remove bit about uninstalling php first
Revision Changes Path
1.4 xml/htdocs/proj/en/php/php-guide.xml
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/php/php-guide.xml?rev=1.4&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/php/php-guide.xml?rev=1.4&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/php/php-guide.xml?r1=1.3&r2=1.4
Index: php-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/php/php-guide.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- php-guide.xml 27 Dec 2010 22:06:16 -0000 1.3
+++ php-guide.xml 5 Jan 2011 12:15:50 -0000 1.4
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/php/php-guide.xml,v 1.3 2010/12/27 22:06:16 darkside Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/php/php-guide.xml,v 1.4 2011/01/05 12:15:50 mabi Exp $ -->
<guide link="php-guide.xml" lang="en">
<title>Upgrading PHP</title>
@@ -20,8 +20,8 @@
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
-<version>1.5</version>
-<date>2010-12-27</date>
+<version>1.6</version>
+<date>2011-01-05</date>
<chapter>
<title>PHP package</title>
@@ -80,17 +80,14 @@
<title>Switching from major to minor version slotting</title>
<section>
-<title>Removing the old installation</title>
+<title>Preperations</title>
-<body><p> You need to deinstall <c>dev-lang/php</c> and
-<c>app-admin/php-toolkit</c>, if you have them installed: </p>
-
-<pre caption="Uninstalling your php setup">
-<i>emerge -C php php-toolkit</i>
-</pre>
+<body>
+<note>Due to popular demand it is now possible to upgrade from major to minor
+version slotting without uninstalling php first</note>
-<note>If you always want PHP extensions compiled for all installed PHP versions,
-you can skip the next step.</note>
+<note>If you always want PHP extensions compiled for the last stable PHP version,
+you can skip the first step.</note>
<p>Decide which versions of PHP you want extensions compiled for and set them
in your <path>/etc/make.conf</path>. </p>
@@ -122,14 +119,17 @@
<p>Update your extensions. If you have installed PHP extensions such as suhosin
or mailparse, you need to reinstall them.<br /> The php team has provided a
minor version slotting compatible version of every package in the
-<c>dev-php5</c> category. They currently have testing keywords only, so you
-might need to add them to your <path>/etc/portage/package.keywords</path> file,
-if you are running an otherwise stable system. </p>
+<c>dev-php5</c> category. </p>
<pre caption="Reinstalling all extensions">
emerge -av $(equery depends dev-lang/php | egrep -v 'dev-php/|/php' | sed -e 's:^:=:')
</pre>
+<warn>Running both PHP versions with different USE flags is not supported.
+You may be able to install packages with differing configurations, but do not file bugs about it breaking.<br />
+The php team is working on a solution that will automate this in the future.
+</warn>
+
<p> Note that <c>PHP_TARGETS</c> is displayed as a USE-expand variable.<br />
Some extensions are not available for all slots (e.g. have not been updated to
work with PHP-5.3). They will indicate this via the <c>USE_PHP</c> variable
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2011-01-05 12:16 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2010-11-20 14:52 [gentoo-commits] gentoo commit in xml/htdocs/proj/en/php: php-guide.xml Matti Bickel (mabi)
-- strict thread matches above, loose matches on Subject: below --
2011-01-05 12:15 Matti Bickel (mabi)
2010-12-27 22:06 Jeremy Olexa (darkside)
2010-04-23 23:42 Matti Bickel (mabi)
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox