Enhancement: Enable and configure header_comment fixer

.php-cs-fixer.php

@@ -1,5 +1,11 @@
 <?php
 
+$header = <<<TXT
+Any ideas?
+
+@see https://github.com/php/web-php
+TXT;
+
 $finder = PhpCsFixer\Finder::create()->in(__DIR__);
 
 $config = new PhpCsFixer\Config();
@@ -20,6 +26,10 @@
     ->setRules([
         'array_indentation' => true,
         'constant_case' => true,
+        'header_comment' => [
+            'comment_type' => 'PHPDoc',
+            'header' => $header,
+        ],
         'indentation_type' => true,
         'line_ending' => true,
         'no_extra_blank_lines' => true,

archive/index.php

@@ -1,4 +1,11 @@
 <?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 include_once __DIR__ . '/../include/prepend.inc';
 $i = 0;
 do {

autoload.php

@@ -1,8 +1,11 @@
 <?php
 
 /**
- * @see https://github.com/php-fig/fig-standards/blob/a1a0674a742c9d07c5dd450209fb33b115ee7b40/accepted/PSR-4-autoloader-examples.md#closure-example
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
  */
+
 spl_autoload_register(static function (string $class): void {
     $prefix = 'phpweb\\';
     $directory = __DIR__ . '/src/';

backend/index.php

@@ -1,5 +1,11 @@
 <?php
-// Simulate a /backend shortcut call (which will lead to a manual page)
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 $_SERVER['REQUEST_URI'] = '/backend';
 include_once __DIR__ . '/../include/prepend.inc';
 include_once __DIR__ . '/../error.php';

bin/index.php

@@ -1,5 +1,11 @@
 <?php
-// Simulate a /bin shortcut call (which will lead to a manual page)
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 $_SERVER['REQUEST_URI'] = '/bin';
 include_once __DIR__ . '/../include/prepend.inc';
 include_once __DIR__ . '/../error.php';

cached.php

@@ -1,15 +1,11 @@
 <?php
-/*
-  Yes, we know this can be used to view the source for any file
-  in the docroot directory. This is intentional and not an LFI
-  vulnerability. The source code for everything in the docroot
-  is publicly available at
 
-    https://github.com/php/web-php
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
 
-  so there is no vulnerability here. You can't use this to view
-  anything that is private.
-*/
 $_SERVER['BASE_PAGE'] = 'cached.php';
 include_once 'include/prepend.inc';
 

conferences/index.php

@@ -1,4 +1,11 @@
 <?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 $_SERVER['BASE_PAGE'] = 'conferences/index.php';
 include_once __DIR__ . '/../include/prepend.inc';
 include_once __DIR__ . '/../include/pregen-news.inc';

credits.php

@@ -1,4 +1,11 @@
 <?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 $_SERVER['BASE_PAGE'] = 'credits.php';
 include_once __DIR__ . '/include/prepend.inc';
 

error.php

@@ -1,13 +1,10 @@
 <?php
-/*
-
- This script handles all 401, 403 and 404 error redirects,
- and some directory requests (like /images). Uses the
- preferred language setting and the REQUEST_URI to guess what
- page should be displayed. In case there is no page that can
- be displayed, the user is redirected to a search page.
 
-*/
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
 
 // Ensure that our environment is set up
 include_once __DIR__ . '/include/prepend.inc';

images/elephpants.php

@@ -1,4 +1,11 @@
 <?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 include_once __DIR__ . '/../include/prepend.inc';
 
 $now = $_SERVER["REQUEST_TIME"];

images/index.php

@@ -1,5 +1,11 @@
 <?php
-// Simulate a /images shortcut call (which will lead to a manual page)
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 $_SERVER['REQUEST_URI'] = '/images';
 include_once __DIR__ . '/../include/prepend.inc';
 include_once __DIR__ . '/../error.php';

images/logo.php

@@ -1,5 +1,11 @@
 <?php
 
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 $refresh = isset($_GET['refresh']);
 
 // Be 100% sure the timezone is set

include/branches.inc

@@ -1,4 +1,11 @@
 <?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 include_once __DIR__ . '/releases.inc';
 include_once __DIR__ . '/version.inc';
 

include/changelogs.inc

@@ -1,4 +1,11 @@
 <?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 function bugfix($number) {
     echo "Fixed bug "; bugl($number);
 }

include/countries.inc

@@ -1,4 +1,11 @@
 <?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 return array(
     'AFG' => 'Afghanistan',
     'ALB' => 'Albania',

include/do-download.inc

@@ -1,10 +1,10 @@
 <?php
 
-/*
-   This code redirects the user to the exact file to
-   download, and logs the download if it's something
-   we would like to know about (PHP binary or source).
-*/
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
 
 function get_actual_download_file($file)
 {

include/email-validation.inc

@@ -1,6 +1,11 @@
 <?php
 
-// Try to remove anti-SPAM bits
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 function clean_AntiSPAM($email)
 {
     $remove_spam = "![-_]?(NO|I[-_]?HATE|DELETE|REMOVE)[-_]?(THIS)?(ME|SPAM)?[-_]?!i";

include/errors.inc

@@ -1,9 +1,10 @@
 <?php
-/*
-  This script provides functions to print out
-  error messages for users in case something is
-  not available.
-*/
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
 
 // A 'good looking' 404 error message page
 function error_404()

include/historical_mirrors.inc

@@ -1,4 +1,11 @@
 <?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 $historical_mirrors = array(
     array("ARG", "ar2.php.net", "XMundo Hosting Solutions", "http://www.xmundo.net"),
     array("ARM", "am1.php.net", "ARMINCO Global Telecommunications", "http://www.arminco.com/"),

include/index.php

@@ -1,5 +1,11 @@
 <?php
-// Simulate a /include shortcut call (which will lead to a manual page)
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 $_SERVER['REQUEST_URI'] = '/include';
 include_once __DIR__ . '/prepend.inc';
 include_once __DIR__ . '/../error.php';

include/ip-to-country.inc

@@ -1,4 +1,10 @@
-<?php // -*- C++ -*-
+<?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
 
 /*
 

include/langchooser.inc

@@ -1,4 +1,10 @@
-<?php // -*- C++ -*-
+<?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
 
 /*
 

include/languages.inc

@@ -1,4 +1,10 @@
-<?php // -*- C++ -*-
+<?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
 
 /*
  This is a list of all manual languages hosted

include/manual-lookup.inc

@@ -1,4 +1,10 @@
-<?php // -*- C++ -*-
+<?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
 
 // We need this for error reporting
 include_once __DIR__ . '/errors.inc';

include/posttohost.inc

@@ -1,10 +1,10 @@
 <?php
 
-/*
- This code is used to post data to the central server which
- can store the data in database and/or mail notices or requests
- to PHP.net stuff and servers
-*/
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
 
 function posttohost($url, $data)
 {

include/releases.inc

@@ -1,4 +1,11 @@
 <?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 $OLDRELEASES = array (
     8 =>
     array (

include/results.inc

@@ -1,4 +1,11 @@
 <?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
+
 function search_results($res, $q, $profile='all', $per_page=10, $s=0, $l='en', $show_title=true, $show_foot=true, $show_attrib=true) {
     $start_result = $s;
     $end_result = $s + $res['ResultSet']['totalResultsReturned'] -1;

include/shared-manual.inc

@@ -1,4 +1,10 @@
-<?php // -*- C++ -*-
+<?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
 
 /*
 

include/site.inc

@@ -1,4 +1,10 @@
-<?php // -*- C++ -*-
+<?php
+
+/**
+ * Any ideas?
+ *
+ * @see https://github.com/php/web-php
+ */
 
 // Define some constants, and $MIRRORS array
 // Mirror type constants