php-src/ext/reflection/tests/ReflectionProperty_getDocComment_basic.phpt
Peter Kokot d679f02295 Sync leading and final newlines in *.phpt sections
This patch adds missing newlines, trims multiple redundant final
newlines into a single one, and trims redundant leading newlines in all
*.phpt sections.

According to POSIX, a line is a sequence of zero or more non-' <newline>'
characters plus a terminating '<newline>' character. [1] Files should
normally have at least one final newline character.

C89 [2] and later standards [3] mention a final newline:
"A source file that is not empty shall end in a new-line character,
which shall not be immediately preceded by a backslash character."

Although it is not mandatory for all files to have a final newline
fixed, a more consistent and homogeneous approach brings less of commit
differences issues and a better development experience in certain text
editors and IDEs.

[1] http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_206
[2] https://port70.net/~nsz/c/c89/c89-draft.html#2.1.1.2
[3] https://port70.net/~nsz/c/c99/n1256.html#5.1.1.2
2018-10-15 04:33:09 +02:00

102 lines
1.5 KiB
PHP

--TEST--
Test ReflectionProperty::getDocComment() usage.
--INI--
opcache.save_comments=1
--FILE--
<?php
class A {
/**
* My Doc Comment for $a
*
*/
public $a = 2, $b, $c = 1;
/**
* My Doc Comment for $d
*/
var $d;
/**Not a doc comment */
private $e;
/**
* Doc comment for $f
*/
static protected $f;
}
class B extends A {
public $a = 2;
/** A doc comment for $b */
var $b, $c = 1;
/** A doc comment for $e */
var $e;
}
foreach(array('A', 'B') as $class) {
$rc = new ReflectionClass($class);
$rps = $rc->getProperties();
foreach($rps as $rp) {
echo "\n\n---> Doc comment for $class::$" . $rp->getName() . ":\n";
var_dump($rp->getDocComment());
}
}
?>
--EXPECTF--
---> Doc comment for A::$a:
string(%d) "/**
* My Doc Comment for $a
*
*/"
---> Doc comment for A::$b:
bool(false)
---> Doc comment for A::$c:
bool(false)
---> Doc comment for A::$d:
string(%d) "/**
* My Doc Comment for $d
*/"
---> Doc comment for A::$e:
bool(false)
---> Doc comment for A::$f:
string(%d) "/**
* Doc comment for $f
*/"
---> Doc comment for B::$a:
bool(false)
---> Doc comment for B::$b:
string(%d) "/** A doc comment for $b */"
---> Doc comment for B::$c:
bool(false)
---> Doc comment for B::$e:
string(%d) "/** A doc comment for $e */"
---> Doc comment for B::$d:
string(%d) "/**
* My Doc Comment for $d
*/"
---> Doc comment for B::$f:
string(%d) "/**
* Doc comment for $f
*/"