Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:53976
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: error (pb1.pair.com: domain roshambo.org from 209.85.210.170 cause and error)
Mime-Version: 1.0 (Apple Message framework v1084)
Content-Type: text/plain; charset=us-ascii
In-Reply-To: <1310735398.2800.59.camel@guybrush>
Date: Fri, 15 Jul 2011 22:15:52 -0700
Cc: Reindl Harald <h.reindl@thelounge.net>,
 internals@lists.php.net
Content-Transfer-Encoding: quoted-printable
Message-ID: <4058F0C7-167E-4600-BBCA-0541E1080EB4@roshambo.org>
References: <9F1FA580-FD3F-4C3F-9E26-51A095CF6EE9@roshambo.org> <1310733992.2800.57.camel@guybrush>  <4E2038EE.7060600@thelounge.net> <1310735398.2800.59.camel@guybrush>
To: =?iso-8859-1?Q?Johannes_Schl=FCter?= <johannes.schlueter@oracle.com>
Subject: Re: [PHP-DEV] deprecating ext/mysql
From: philip@roshambo.org (Philip Olson)

Hola friends,

Nice feedback so far, and the PHP documentation will begin implementing=20=

the ideas presented here, and focus on mysqli but also recommend =
pdo_mysql.=20
Therefore, the ext/mysql documentation will be improved to strongly=20
recommend the preferred alternatives that have existed since PHP 5.0.0.=20=


We'll work on the finer details but it feels like procedural mysqli is a=20=

better fit to live alongside the ext/mysql examples, although we don't =
want=20
to confuse people. Maybe geeks here have ideas regarding this, but a =
clear
useful clutter-free solution will be worked out, which may include =
adjusting
the CSS and involve creative linking. I'll add an example or three =
soonish.

However, there has been some confusion within the PHP community, so to =
help=20
ease these concerns:

 - This proposal only deals with documentation/education... so it can be=20=

   described as an official 'soft deprecation' (no errors or code =
changes)
 - When (if?) this extension emits errors, or is removed, is not part of
   this proposal
 - There is a 100% chance that additional tasks and ideas will be =
discussed=20
   in the future, which might include:
   - A conversion tool/guide
   - A wrapper
   - A PECL extension
   - Talking to distros/hosters and apps like wordpress
   - ...
 - php.net understands that ext/mysql is popular, and we're handling =
this=20
   with extra care and heck, parts of *.php.net is powered by ext/mysql
 - Seriously, no need to panic

We'll document the reasons why the other MySQL extensions are preferred, =
but=20
if people want to use the old ext/mysql API with PHP 9.0.0 (just an =
example)
then I'm guessing an old geek out there will make that possible. We, =
however,=20
will do our best to convince users to move towards the preferred and=20
supported methods, and hopefully write better code along the way because
honestly, that's the ultimate goal here.

Regards,
Philip