From cff442d96470684ed139dbaafceb4c01a45a0823 Mon Sep 17 00:00:00 2001 From: fadrian06 Date: Fri, 14 Aug 2026 01:57:43 -0400 Subject: [PATCH 1/2] normalize and simplify @copyright and @license phpdoc tags based on phpDocumentor recommendations to clean symbols hovers --- flight/core/Dispatcher.php | 4 ++-- flight/core/Loader.php | 4 ++-- flight/net/Request.php | 4 ++-- flight/net/Response.php | 4 ++-- flight/net/Route.php | 4 ++-- flight/net/Router.php | 4 ++-- flight/template/View.php | 4 ++-- flight/util/Collection.php | 4 ++-- 8 files changed, 16 insertions(+), 16 deletions(-) diff --git a/flight/core/Dispatcher.php b/flight/core/Dispatcher.php index 62ff7f9..f0f5b2a 100644 --- a/flight/core/Dispatcher.php +++ b/flight/core/Dispatcher.php @@ -18,8 +18,8 @@ use TypeError; * allows you to hook other functions to an event that can modify the * input parameters and/or the output. * - * @license MIT, http://flightphp.com/license - * @copyright Copyright (c) 2011, Mike Cao + * @copyright 2011 [Mike Cao](https://mikecao.com) + * @license https://docs.flightphp.com/license MIT * @phpstan-template EngineTemplate of object */ class Dispatcher diff --git a/flight/core/Loader.php b/flight/core/Loader.php index 92deceb..63bafd9 100644 --- a/flight/core/Loader.php +++ b/flight/core/Loader.php @@ -13,8 +13,8 @@ use Exception; * instances with custom initialization parameters. It also performs * class autoloading. * - * @license MIT, http://flightphp.com/license - * @copyright Copyright (c) 2011, Mike Cao + * @copyright 2011 [Mike Cao](https://mikecao.com) + * @license https://docs.flightphp.com/license MIT */ class Loader { diff --git a/flight/net/Request.php b/flight/net/Request.php index 24f02a5..fadd956 100644 --- a/flight/net/Request.php +++ b/flight/net/Request.php @@ -11,8 +11,8 @@ use flight\util\Collection; * all the super globals $_GET, $_POST, $_COOKIE, and $_FILES * are stored and accessible via the Request object. * - * @license MIT, http://flightphp.com/license - * @copyright Copyright (c) 2011, Mike Cao + * @copyright 2011 [Mike Cao](https://mikecao.com) + * @license https://docs.flightphp.com/license MIT * * The default request properties are: * diff --git a/flight/net/Response.php b/flight/net/Response.php index 1a738cf..883bb9c 100644 --- a/flight/net/Response.php +++ b/flight/net/Response.php @@ -12,8 +12,8 @@ use flight\core\EventDispatcher; * contains the response headers, HTTP status code, and response * body. * - * @license MIT, http://flightphp.com/license - * @copyright Copyright (c) 2011, Mike Cao + * @copyright 2011 [Mike Cao](https://mikecao.com) + * @license https://docs.flightphp.com/license MIT */ class Response { diff --git a/flight/net/Route.php b/flight/net/Route.php index 47f93dc..434bfca 100644 --- a/flight/net/Route.php +++ b/flight/net/Route.php @@ -9,8 +9,8 @@ namespace flight\net; * an assigned callback function. The Router tries to match the * requested URL against a series of URL patterns. * - * @license MIT, http://flightphp.com/license - * @copyright Copyright (c) 2011, Mike Cao + * @copyright 2011 [Mike Cao](https://mikecao.com) + * @license https://docs.flightphp.com/license MIT */ class Route { diff --git a/flight/net/Router.php b/flight/net/Router.php index 0ec9724..a5d5150 100644 --- a/flight/net/Router.php +++ b/flight/net/Router.php @@ -12,8 +12,8 @@ use flight\net\Route; * an assigned callback function. The Router tries to match the * requested URL against a series of URL patterns. * - * @license MIT, http://flightphp.com/license - * @copyright Copyright (c) 2011, Mike Cao + * @copyright 2011 [Mike Cao](https://mikecao.com) + * @license https://docs.flightphp.com/license MIT */ class Router { diff --git a/flight/template/View.php b/flight/template/View.php index f995d36..758777a 100644 --- a/flight/template/View.php +++ b/flight/template/View.php @@ -9,8 +9,8 @@ namespace flight\template; * methods for managing view data and inserts the data into * view templates upon rendering. * - * @license MIT, http://flightphp.com/license - * @copyright Copyright (c) 2011, Mike Cao + * @copyright 2011 [Mike Cao](https://mikecao.com) + * @license https://docs.flightphp.com/license MIT */ class View { diff --git a/flight/util/Collection.php b/flight/util/Collection.php index e17ed37..17142e9 100644 --- a/flight/util/Collection.php +++ b/flight/util/Collection.php @@ -13,10 +13,10 @@ use JsonSerializable; * The Collection class allows you to access a set of data * using both array and object notation. * - * @license MIT, http://flightphp.com/license - * @copyright Copyright (c) 2011, Mike Cao + * @copyright 2011 [Mike Cao](https://mikecao.com) * @implements ArrayAccess * @implements Iterator + * @license https://docs.flightphp.com/license MIT */ class Collection implements ArrayAccess, Iterator, Countable, JsonSerializable { From 32ff66428dbc67327f17fc6492b17c20e02f768b Mon Sep 17 00:00:00 2001 From: fadrian06 Date: Fri, 14 Aug 2026 02:11:14 -0400 Subject: [PATCH 2/2] use raw copyright links for compatibility --- flight/Engine.php | 8 ++------ flight/Flight.php | 7 ++----- flight/core/Dispatcher.php | 2 +- flight/core/Loader.php | 2 +- flight/net/Request.php | 2 +- flight/net/Response.php | 2 +- flight/net/Route.php | 2 +- flight/net/Router.php | 2 +- flight/template/View.php | 2 +- flight/util/Collection.php | 2 +- 10 files changed, 12 insertions(+), 19 deletions(-) diff --git a/flight/Engine.php b/flight/Engine.php index 880decf..ac56867 100644 --- a/flight/Engine.php +++ b/flight/Engine.php @@ -24,8 +24,7 @@ use Psr\Container\ContainerInterface; * It is responsible for loading an HTTP request, running the assigned services, * and generating an HTTP response. * - * @license MIT, https://docs.flightphp.com/license - * @copyright Copyright (c) 2011-2025, Mike Cao , n0nag0n + * @copyright 2011-2026, Mike Cao https://mikecao.com, n0nag0n * * @method void start() * @method void stop() @@ -75,10 +74,7 @@ use Psr\Container\ContainerInterface; * @phpstan-method void json(mixed $data, int $code = 200, bool $encode = true, string $charset = "utf8", int $encodeOption = 0, int $encodeDepth = 512) * @phpstan-method void jsonHalt(mixed $data, int $code = 200, bool $encode = true, string $charset = 'utf-8', int $option = 0) * @phpstan-method void jsonp(mixed $data, string $param = 'jsonp', int $code = 200, bool $encode = true, string $charset = "utf8", int $encodeOption = 0, int $encodeDepth = 512) - * - * Note: IDEs will use standard @method tags for autocompletion, while PHPStan will use @phpstan-* tags for advanced type checking. - * - * phpcs:disable PSR2.Methods.MethodDeclaration.Underscore + * @license https://docs.flightphp.com/license MIT */ class Engine { diff --git a/flight/Flight.php b/flight/Flight.php index ddb536f..b975197 100644 --- a/flight/Flight.php +++ b/flight/Flight.php @@ -15,7 +15,7 @@ use Psr\Container\ContainerInterface; * The Flight class is a static representation of the framework. * * @license MIT, https://docs.flightphp.com/license - * @copyright Copyright (c) 2011-2025, Mike Cao , n0nag0n + * @copyright 2011-2026, Mike Cao https://mikecao.com, n0nag0n * * @method static void start() * @method static void path(string $dir) @@ -77,11 +77,8 @@ use Psr\Container\ContainerInterface; * @phpstan-method static void json(mixed $data, int $code = 200, bool $encode = true, string $charset = "utf8", int $encodeOption = 0, int $encodeDepth = 512) * @phpstan-method static void jsonHalt(mixed $data, int $code = 200, bool $encode = true, string $charset = 'utf-8', int $option = 0) * @phpstan-method static void jsonp(mixed $data, string $param = 'jsonp', int $code = 200, bool $encode = true, string $charset = "utf8", int $encodeOption = 0, int $encodeDepth = 512) - * - * Note: IDEs will use standard @method tags for autocompletion, - * while PHPStan will use @phpstan-* tags for advanced type checking. + * @license https://docs.flightphp.com/license MIT */ -// phpcs:ignore PSR1.Classes.ClassDeclaration.MissingNamespace class Flight { /** diff --git a/flight/core/Dispatcher.php b/flight/core/Dispatcher.php index f0f5b2a..ea25e60 100644 --- a/flight/core/Dispatcher.php +++ b/flight/core/Dispatcher.php @@ -18,7 +18,7 @@ use TypeError; * allows you to hook other functions to an event that can modify the * input parameters and/or the output. * - * @copyright 2011 [Mike Cao](https://mikecao.com) + * @copyright 2011 Mike Cao https://mikecao.com * @license https://docs.flightphp.com/license MIT * @phpstan-template EngineTemplate of object */ diff --git a/flight/core/Loader.php b/flight/core/Loader.php index 63bafd9..a3f52cb 100644 --- a/flight/core/Loader.php +++ b/flight/core/Loader.php @@ -13,7 +13,7 @@ use Exception; * instances with custom initialization parameters. It also performs * class autoloading. * - * @copyright 2011 [Mike Cao](https://mikecao.com) + * @copyright 2011 Mike Cao https://mikecao.com * @license https://docs.flightphp.com/license MIT */ class Loader diff --git a/flight/net/Request.php b/flight/net/Request.php index fadd956..a2dcb48 100644 --- a/flight/net/Request.php +++ b/flight/net/Request.php @@ -11,7 +11,7 @@ use flight\util\Collection; * all the super globals $_GET, $_POST, $_COOKIE, and $_FILES * are stored and accessible via the Request object. * - * @copyright 2011 [Mike Cao](https://mikecao.com) + * @copyright 2011 Mike Cao https://mikecao.com * @license https://docs.flightphp.com/license MIT * * The default request properties are: diff --git a/flight/net/Response.php b/flight/net/Response.php index 883bb9c..cd0e2a1 100644 --- a/flight/net/Response.php +++ b/flight/net/Response.php @@ -12,7 +12,7 @@ use flight\core\EventDispatcher; * contains the response headers, HTTP status code, and response * body. * - * @copyright 2011 [Mike Cao](https://mikecao.com) + * @copyright 2011 Mike Cao https://mikecao.com * @license https://docs.flightphp.com/license MIT */ class Response diff --git a/flight/net/Route.php b/flight/net/Route.php index 434bfca..d27df37 100644 --- a/flight/net/Route.php +++ b/flight/net/Route.php @@ -9,7 +9,7 @@ namespace flight\net; * an assigned callback function. The Router tries to match the * requested URL against a series of URL patterns. * - * @copyright 2011 [Mike Cao](https://mikecao.com) + * @copyright 2011 Mike Cao https://mikecao.com * @license https://docs.flightphp.com/license MIT */ class Route diff --git a/flight/net/Router.php b/flight/net/Router.php index a5d5150..770ab9c 100644 --- a/flight/net/Router.php +++ b/flight/net/Router.php @@ -12,7 +12,7 @@ use flight\net\Route; * an assigned callback function. The Router tries to match the * requested URL against a series of URL patterns. * - * @copyright 2011 [Mike Cao](https://mikecao.com) + * @copyright 2011 Mike Cao https://mikecao.com * @license https://docs.flightphp.com/license MIT */ class Router diff --git a/flight/template/View.php b/flight/template/View.php index 758777a..fae471f 100644 --- a/flight/template/View.php +++ b/flight/template/View.php @@ -9,7 +9,7 @@ namespace flight\template; * methods for managing view data and inserts the data into * view templates upon rendering. * - * @copyright 2011 [Mike Cao](https://mikecao.com) + * @copyright 2011 Mike Cao https://mikecao.com * @license https://docs.flightphp.com/license MIT */ class View diff --git a/flight/util/Collection.php b/flight/util/Collection.php index 17142e9..5b2c4a3 100644 --- a/flight/util/Collection.php +++ b/flight/util/Collection.php @@ -13,7 +13,7 @@ use JsonSerializable; * The Collection class allows you to access a set of data * using both array and object notation. * - * @copyright 2011 [Mike Cao](https://mikecao.com) + * @copyright 2011 Mike Cao https://mikecao.com * @implements ArrayAccess * @implements Iterator * @license https://docs.flightphp.com/license MIT