Allow gen_stub.php to parse and ignore extended docblock types

Extended docblock types, according to psalm or phpstan conventions may include array shapes, callable signatures etc.. These ar

Allow gen_stub.php to parse and ignore extended docblock types

Extended docblock types, according to psalm or phpstan conventions may include array shapes, callable signatures etc.. These are now ignored by ignoring any nested parenthesized expression (followed by optional :type) at the end of the type.

show more ...

Add a couple clarifying comments

Honor constant expressions instead of just taking the last constant encountered in stubs

As an example:
should be translated to:
ZVAL_LONG(&attribute_Attribute_class_test_arg0, ZEND_

Honor constant expressions instead of just taking the last constant encountered in stubs

As an example:
should be translated to:
ZVAL_LONG(&attribute_Attribute_class_test_arg0, ZEND_ATTRIBUTE_TARGET_FUNCTION | ZEND_ATTRIBUTE_TARGET_METHOD);

show more ...

Escape the role attribute of namespaced classes (#9952)

Make the usage of the role attribute more clear (#9901)

Currently, the role attribute is mainly used to differentiate OO and procedural "aliases" when they are documented on the same page (e

Make the usage of the role attribute more clear (#9901)

Currently, the role attribute is mainly used to differentiate OO and procedural "aliases" when they are documented on the same page (e.g. https://www.php.net/manual/en/datetime.diff.php). However, these function-method counterparts are not always aliases in fact according to the stubs (#9491). That's why sometimes the usage of the role attribute is ambiguous, thus syncing the manual with the stubs results in false positive diffs.

This change fixes the problem by a very obtrusive way: by changing the value of all role="oop" attributes to the actual class name, like role="DateTime", and by getting rid of all role="procedural" attributes as they became unnecessary. This way, class synopsis pages can clearly reference methods, and skip functions. Additionally, gen_stub.php will be able to generate the correct methodsynopsis role even though a single page describes multiple methods, like `DateTime/DateTimeImmutable/DateTimeInterface::diff()`.

show more ...

Check that all preprocessor conditions are terminated

Fix GH-12558 Escape \N in generated stubs (#12562)

Revert "Fix GH-9967 Add support for generating custom function, class const, and property attributes in stubs"

This reverts commit d7ab0ff0c81bf672c3d4ac73e1b2cbd158296eef.

Fix GH-9967 Add support for generating custom function, class const, and property attributes in stubs

Fixed macro generation for variadics, which don't have a default value

Add support for generating namespaced constant

Closes GH-10552

Do not list private constructors as inherited

Do not display non-existent constructors

Better document constructors

Until https://github.com/php/php-src/pull/10098 default constructors were sometimes documented, sometimes omitted. The above PR made adding documentation for con

Better document constructors

Until https://github.com/php/php-src/pull/10098 default constructors were sometimes documented, sometimes omitted. The above PR made adding documentation for constructor of all non-abstract classes required. However, this is not desired when such a class inherits a constructor from its parent. The current PR fixes the behavior the following way:
- documents inherited constructors (along with destructors)
- makes it possible to generate/replace the methodsynopsis of implicit default constructors which don't have a stub counterpart

show more ...

Only include the default constructor for non-abstract class synopses

Backport methodsynopsis role attributes changes from master

Commits https://github.com/php/php-src/commit/93605f286d11876da44d2ecd41c13d7e3f0aae66 and https://github.com/php/php-src/commit/d

Backport methodsynopsis role attributes changes from master

Commits https://github.com/php/php-src/commit/93605f286d11876da44d2ecd41c13d7e3f0aae66 and https://github.com/php/php-src/commit/d6651426f405342f74cdfe930448912ef68e23c4

show more ...

Always include the constructor on the class manual pages

Remove the superfluous closing parentheses from class synopsis page includes

Replace another root XML element format to the "canonical" one

Do not display the value of UNKNOWN constants in the manual (#9843)

Generate constant declarations with the CONST_CS flag for PHP 7.x

Improve string class constant code generation (#9577)

Using strlen() will make sure that non-constant values can also be used.

Use PHP 7.4 syntax in gen_stub.php

Validate if the refpurpose and the description is in sync (#9510)

Add support for validation of missing method synopses (#9491)