Everything

php

Home » Project » Newsgroups » php.internals » 7.3 features in announcement »

7.3 features in announcement

php.internals

Jakub Zelenka

7 years ago

Hi,

I was wondering if we have got a final list of the top features that will
be listed in the announcement for the stable release.

Not sure how it's usually selected but thought that it would be good to
list FPM logging changes that I have been working on and it's the main
improvement in FPM [1]. It's not probably that interesting for PHP devs but
it might be quite importants for DevOps who use FPM with Docker and want to
properly collect logs from containers. My current client will be updating
to 7.3 pretty soon just because of that.

[1] https://github.com/php/php-src/pull/2458

Cheers

Jakub

Christoph Becker

7 years ago

On 02.12.2018 at 21:24, Jakub Zelenka wrote:

> I was wondering if we have got a final list of the top features that will
> be listed in the announcement for the stable release.
>
> Not sure how it's usually selected but thought that it would be good to
> list FPM logging changes that I have been working on and it's the main
> improvement in FPM [1]. It's not probably that interesting for PHP devs but
> it might be quite importants for DevOps who use FPM with Docker and want to
> properly collect logs from containers. My current client will be updating
> to 7.3 pretty soon just because of that.
>
> [1] https://github.com/php/php-src/pull/2458

Thanks for bringing this up, Jakub!  To be honest, I haven't really
thought about the release announcement before, so this is a fine reminder.

Regarding the FPM logging changes: indeed, this seems to be quite an
improvement! :)  However, it seems there is no note in UPGRADING (which
is important for the migration guide in the manual) yet.  Could you
please add the missing note?

Regarding other prominent features, I think the “Flexible Heredoc and
Nowdoc Syntaxes”[2] and the “PCRE2 migration”[3] should certainly be
mentioned.  Also the MBString improvements[4], as well as the
deprecations[5], and also the file related Windows improvements[6].

I'm likely missing other important changes, and may overestimate some of
those I've mentionened above.  I'm looking forward to suggestions!

[2] <https://wiki.php.net/rfc/flexible_heredoc_nowdoc_syntaxes>
[3] <https://wiki.php.net/rfc/pcre2-migration>
[4] <https://github.com/php/php-src/blob/php-7.3.0RC6/UPGRADING#L186-L232>
[5] <https://github.com/php/php-src/blob/php-7.3.0RC6/UPGRADING#L259-L323>
[6] <https://github.com/php/php-src/blob/php-7.3.0RC6/UPGRADING#L643-L647>

--
Christoph M. Becker

Côme Chilliet

7 years ago

Le dimanche 2 décembre 2018, 23:50:54 CET Christoph M. Becker a écrit :

> I'm likely missing other important changes, and may overestimate some of
> those I've mentionened above.  I'm looking forward to suggestions!

It would be good if LDAP controls support in php-ldap is advertised, as it also shows the module is maintained again.

Sadly I do not have a good link to give for this, I’m gonna try and fill the documentation about this so that it can be linked to.

Côme

Christoph Becker

7 years ago

On 03.12.2018 at 12:08, Côme Chilliet:

> Le dimanche 2 décembre 2018, 23:50:54 CET Christoph M. Becker a écrit :
>
>> I'm likely missing other important changes, and may overestimate some of
>> those I've mentionened above.  I'm looking forward to suggestions!
>
> It would be good if LDAP controls support in php-ldap is advertised, as it also shows the module is maintained again.
>
> Sadly I do not have a good link to give for this, I’m gonna try and fill the documentation about this so that it can be linked to.

Thanks!  Indeed, PR #2640 looks like a considerable improvement.  Please
add a respective entry in UPGRADING (either self-explaining, or linking
to another document).

--
Christoph M. Becker

Côme Chilliet

7 years ago

Le lundi 3 décembre 2018, 12:37:45 CET Christoph M. Becker a écrit :

> Thanks!  Indeed, PR #2640 looks like a considerable improvement.  Please
> add a respective entry in UPGRADING (either self-explaining, or linking
> to another document).

I started https://secure.php.net/manual/en/ldap.controls.php and adding documentation for the new functions as well (The online version is outdated last version is in the svn).
It’s not clear for me in which branch I should edit UPGRADING, it seems master is now 7.4, should I edit in PHP-7.3 or PHP-7.3.0? What’s the difference?

Also what is the difference between UPGRADING and NEWS?

Regarding the online documentation, it seems http://doc.php.net/tutorial/ is down as well as http://docs.php.net/

Côme

Christoph Becker

7 years ago

On 04.12.2018 at 16:09, Côme Chilliet wrote:

> Le lundi 3 décembre 2018, 12:37:45 CET Christoph M. Becker a écrit :
>> Thanks!  Indeed, PR #2640 looks like a considerable improvement.  Please
>> add a respective entry in UPGRADING (either self-explaining, or linking
>> to another document).
>
> I started https://secure.php.net/manual/en/ldap.controls.php and adding documentation for the new functions as well

Thanks on behalf of the doc team!

> (The online version is outdated last version is in the svn).

Yeah, the PHP manual is rolled out only once a day to the mirrors.
docs.php.net is supposed to be updated every 4 or 6 hours.

> It’s not clear for me in which branch I should edit UPGRADING, it seems master is now 7.4, should I edit in PHP-7.3 or PHP-7.3.0? What’s the difference?

PHP-7.3 is the main branch for 7.3; please commit relevant changes to
UPGRADING there (and merge up to master).  PHP-7.3.0 is the release
branch, which usually is maintained by the RMs only, who cherry-pick
important commits from PHP-7.3 into it.

> Also what is the difference between UPGRADING and NEWS?

NEWS is for all news (including bug fixes), and usually has only very
brief notes.  Also it has sections for every PHP *revision*, and is made
available as change log[1].  UPGRADING has often more verbose
information which serves as upgrading information for a *minor* PHP
version.  UPGRADING also serves as base for the migration guide[2] in
the PHP manual.

> Regarding the online documentation, it seems http://doc.php.net/tutorial/ is down as well as http://docs.php.net/

Indeed!  Guess we should wait a while, and if it's still not up again
then, someone should file a bug report.

[1] e.g. <http://php.net/ChangeLog-7.php#7.2.12>
[2] e.g. <http://php.net/manual/en/migration72.php>

--
Christoph M. Becker

Côme Chilliet

7 years ago

Le mardi 4 décembre 2018, 16:35:14 CET Christoph M. Becker a écrit :

> PHP-7.3 is the main branch for 7.3; please commit relevant changes to
> UPGRADING there (and merge up to master).  PHP-7.3.0 is the release
> branch, which usually is maintained by the RMs only, who cherry-pick
> important commits from PHP-7.3 into it.

I pushed to PHP-7.3 but could not merge into master due to a Karma problem:

> remote: Welcome mcmic.
> remote: You have insufficient Karma!
> remote: I'm sorry, I cannot allow you to write to
> remote:     php-src.git/
> remote: Have a nice day.
> To git.php.net:/php-src.git
>  ! [remote rejected]       master -> master (pre-receive hook declined)

Côme

Christoph Becker

7 years ago

On 04.12.2018 at 20:53, Côme Chilliet wrote:

> I pushed to PHP-7.3

Thanks!

> but could not merge into master due to a Karma problem:
>
>> remote: Welcome mcmic.
>> remote: You have insufficient Karma!
>> remote: I'm sorry, I cannot allow you to write to
>> remote:     php-src.git/
>> remote: Have a nice day.
>> To git.php.net:/php-src.git
>>  ! [remote rejected]       master -> master (pre-receive hook declined)

You should definitely have sufficient karma to push to master, if you
are allowed to push to PHP-7.3.  Not sure what went wrong there; have
you configured the mandatory Git settings[1]?

Anyhow, I've merged into master and pushed now, to avoid potential merge
issues for others.

[1] <https://wiki.php.net/vcs/gitfaq#mandatory_git_settings>

--
Christoph M. Becker

Tom Worster

7 years ago

On 2 Dec 2018, at 17:50, Christoph M. Becker wrote:

> Regarding other prominent features, I think the “Flexible Heredoc and
> Nowdoc Syntaxes”[2] and the “PCRE2 migration”[3] should certainly be
> mentioned.  Also the MBString improvements[4], as well as the
> deprecations[5], and also the file related Windows improvements[6].
>
> I'm likely missing other important changes, and may overestimate some of
> those I've mentionened above.  I'm looking forward to suggestions!
>
> [2] <https://wiki.php.net/rfc/flexible_heredoc_nowdoc_syntaxes>
> [3] <https://wiki.php.net/rfc/pcre2-migration>
> [4] <https://github.com/php/php-src/blob/php-7.3.0RC6/UPGRADING#L186-L232>
> [5] <https://github.com/php/php-src/blob/php-7.3.0RC6/UPGRADING#L259-L323>
> [6] <https://github.com/php/php-src/blob/php-7.3.0RC6/UPGRADING#L643-L647>

Hi Christoph,

Do I read right that in 7.3 pcre gets UCD 10 while mbstring gets UCD 11?

And intl's UCD depends on the linked ICU library, right?

Tom

Christoph Becker

7 years ago

On 03.12.2018 at 18:49, Tom Worster wrote:

> Do I read right that in 7.3 pcre gets UCD 10 while mbstring gets UCD 11?

MBString gets UCD11; PCRE's UCD depend on libpcre2; for instance,
Debians libpcre2-dev (10.22-3) supports UCD 8.

> And intl's UCD depends on the linked ICU library, right?

Yes.

--
Christoph M. Becker

Jakub Zelenka

7 years ago

On Sun, Dec 2, 2018 at 10:50 PM Christoph M. Becker <cmbecker69@gmx.de>
wrote:

> On 02.12.2018 at 21:24, Jakub Zelenka wrote:
>
> > I was wondering if we have got a final list of the top features that will
> > be listed in the announcement for the stable release.
> >
> > Not sure how it's usually selected but thought that it would be good to
> > list FPM logging changes that I have been working on and it's the main
> > improvement in FPM [1]. It's not probably that interesting for PHP devs
> but
> > it might be quite importants for DevOps who use FPM with Docker and want
> to
> > properly collect logs from containers. My current client will be updating
> > to 7.3 pretty soon just because of that.
> >
> > [1] https://github.com/php/php-src/pull/2458
>
> Thanks for bringing this up, Jakub!  To be honest, I haven't really
> thought about the release announcement before, so this is a fine reminder.
>
> Regarding the FPM logging changes: indeed, this seems to be quite an
> improvement! :)  However, it seems there is no note in UPGRADING (which
> is important for the migration guide in the manual) yet.  Could you
> please add the missing note?
>
>

That's a good point! Just added some extra info to the UPGRADING!

I guess the release note about these changes should be a bit shorter. Maybe
something like (feel free to edit it :) ):

Improved FPM logging with options to remove output decorations and
extending limit on number of characters in the logged message.

Cheers

Jakub

Christoph Becker

7 years ago

On 03.12.2018 at 19:37, Jakub Zelenka wrote:

> On Sun, Dec 2, 2018 at 10:50 PM Christoph M. Becker <cmbecker69@gmx.de>
> wrote:
>
>> Regarding the FPM logging changes: indeed, this seems to be quite an
>> improvement! :)  However, it seems there is no note in UPGRADING (which
>> is important for the migration guide in the manual) yet.  Could you
>> please add the missing note?
>
> That's a good point! Just added some extra info to the UPGRADING!

Thanks!

> I guess the release note about these changes should be a bit shorter. Maybe
> something like (feel free to edit it :) ):
>
> Improved FPM logging with options to remove output decorations and
> extending limit on number of characters in the logged message.

The PHP 7.1.0[1] and 7.2.0[2] release announcements only had a lists of
linked captions, and I'm planning to follow suit.

[1] <http://php.net/archive/2016.php#id2016-12-01-3>
[2] <http://php.net/archive/2017.php#id2017-11-30-1>

--
Christoph M. Becker

Nikita Popov

7 years ago

On Sun, Dec 2, 2018 at 11:51 PM Christoph M. Becker <cmbecker69@gmx.de>
wrote:

> On 02.12.2018 at 21:24, Jakub Zelenka wrote:
>
> > I was wondering if we have got a final list of the top features that will
> > be listed in the announcement for the stable release.
> >
> > Not sure how it's usually selected but thought that it would be good to
> > list FPM logging changes that I have been working on and it's the main
> > improvement in FPM [1]. It's not probably that interesting for PHP devs
> but
> > it might be quite importants for DevOps who use FPM with Docker and want
> to
> > properly collect logs from containers. My current client will be updating
> > to 7.3 pretty soon just because of that.
> >
> > [1] https://github.com/php/php-src/pull/2458
>
> Thanks for bringing this up, Jakub!  To be honest, I haven't really
> thought about the release announcement before, so this is a fine reminder.
>
> Regarding the FPM logging changes: indeed, this seems to be quite an
> improvement! :)  However, it seems there is no note in UPGRADING (which
> is important for the migration guide in the manual) yet.  Could you
> please add the missing note?
>

Speaking of which, what's the state of the migration guide for 7.3? I think
it is usually available by the time of the GA release, but I can't find it
on deployed docs (and docs.php.net seems down...)

Nikita

Christoph Becker

7 years ago

On 04.12.2018 at 16:17, Nikita Popov wrote:

> Speaking of which, what's the state of the migration guide for 7.3? I think
> it is usually available by the time of the GA release, but I can't find it
> on deployed docs (and docs.php.net seems down...)

I'm already working on it, and will commit something useable today or
tomorrow.

--
Christoph M. Becker