Enhance PHP API Ref

[adriendupuis]

Question	Answer
JIRA Ticket	N/A
Versions	master, 4.6
Edition	All

• Add template for traits.
  • Before doesn't look like classes and interfaces' pages.
  • After has the right design.
• Workaround duplicated properties issue (Duplicated magic property phpDocumentor/phpDocumentor#3716).
  • Deduplicate properties from right side ToC.
  • Group duplicates in center main doc.
  • Before has two depth properties in the right ToC, those two are far from each other in the center page but have the same anchor which complicates navigation.
  • After has one depth in the ToC, the two central ones are close to each other.
• More external links to https://github.com/symfony/symfony/blob/5.4
  • Before: only extended abstract class is a link.
  • After: redirectToLocation() returned value class is also a link.
• Display "Abstract", "Interface", and "Trait".
  • Before: Not clear that this is an abstract class.
  • After is indicated as abstract under the class name.
• Support @used-by tag.
  • Not used yet but could be in the future.
  • Tested locally.

TODO: Merge #2585 before merging this one.

Checklist

• Text renders correctly
• Text has been checked with vale
• Description metadata is up to date
• Redirects cover removed/moved pages
• Code samples are working
• PHP code samples have been fixed with PHP CS fixer
• Added link to this PR in relevant JIRA ticket or code PR

[adriendupuis]

I tested all the generated external links and found no error.

<?php

$symfonyVersion = '5.4';
foreach (explode(PHP_EOL, trim(`find docs/api/php_api/php_api_reference/classes -type f`)) as $filePath) {
    //echo "$filePath\n";
    $grepCmd = "grep '<abbr title=\"\\\\Symfony\\\\' $filePath";
    $grepLines = shell_exec($grepCmd);
    if ($grepLines) {
        foreach (explode(PHP_EOL, trim($grepLines)) as $grepLine) {
            preg_match_all('/<abbr title="(?P<fqcn>\\\\Symfony\\\\[^"]+)"/', $grepLine, $matches);
            foreach ($matches['fqcn'] as $fqcn) {
                $href = 'https://github.com/symfony/symfony/blob/' . $symfonyVersion . '/src' . str_replace('\\', '/', $fqcn) . '.php';
                //echo "$href\n";
                $headers = @get_headers($href);
                if (empty($headers)) {
                    sleep(2);
                    $headers = @get_headers($href);
                }
                if (empty($headers)) {
                    echo "$filePath 'HTTP request failed' $href\n";
                } elseif ('HTTP/1.1 200 OK' !== $headers[0]) {
                    echo "$filePath '{$headers[0]}' $href\n";
                }
            }
        }
    }
}