diff --git a/_ide_helper.php b/_ide_helper.php index 2b7789698..2d84c9f20 100644 --- a/_ide_helper.php +++ b/_ide_helper.php @@ -23,6 +23,7 @@ * This file should not be included in your code, only analyzed by your IDE! * * @author Barry vd. Heuvel + * * @see https://github.com/barryvdh/laravel-ide-helper */ @@ -36,6 +37,7 @@ class App * Get the version number of the Laravel framework. * * @return string + * * @author Seven Du * @static */ @@ -60,7 +62,7 @@ public static function registerCoreContainerAliases() /** * The app configure path. * - * @param string $path + * @param string $path * @return string * @static */ @@ -97,7 +99,7 @@ public static function version() /** * Run the given array of bootstrap classes. * - * @param string[] $bootstrappers + * @param string[] $bootstrappers * @return void * @static */ @@ -110,7 +112,7 @@ public static function bootstrapWith($bootstrappers) /** * Register a callback to run after loading the environment. * - * @param \Closure $callback + * @param \Closure $callback * @return void * @static */ @@ -123,8 +125,8 @@ public static function afterLoadingEnvironment($callback) /** * Register a callback to run before a bootstrapper. * - * @param string $bootstrapper - * @param \Closure $callback + * @param string $bootstrapper + * @param \Closure $callback * @return void * @static */ @@ -137,8 +139,8 @@ public static function beforeBootstrapping($bootstrapper, $callback) /** * Register a callback to run after a bootstrapper. * - * @param string $bootstrapper - * @param \Closure $callback + * @param string $bootstrapper + * @param \Closure $callback * @return void * @static */ @@ -163,7 +165,7 @@ public static function hasBeenBootstrapped() /** * Set the base path for the application. * - * @param string $basePath + * @param string $basePath * @return \Zhiyi\Plus\Application * @static */ @@ -176,7 +178,7 @@ public static function setBasePath($basePath) /** * Get the path to the application "app" directory. * - * @param string $path + * @param string $path * @return string * @static */ @@ -189,7 +191,7 @@ public static function path($path = '') /** * Set the application directory. * - * @param string $path + * @param string $path * @return \Zhiyi\Plus\Application * @static */ @@ -202,7 +204,7 @@ public static function useAppPath($path) /** * Get the base path of the Laravel installation. * - * @param string $path Optionally, a path to append to the base path + * @param string $path Optionally, a path to append to the base path * @return string * @static */ @@ -215,7 +217,7 @@ public static function basePath($path = '') /** * Get the path to the bootstrap directory. * - * @param string $path Optionally, a path to append to the bootstrap path + * @param string $path Optionally, a path to append to the bootstrap path * @return string * @static */ @@ -228,7 +230,7 @@ public static function bootstrapPath($path = '') /** * Get the path to the application configuration files. * - * @param string $path Optionally, a path to append to the config path + * @param string $path Optionally, a path to append to the config path * @return string * @static */ @@ -241,7 +243,7 @@ public static function configPath($path = '') /** * Get the path to the database directory. * - * @param string $path Optionally, a path to append to the database path + * @param string $path Optionally, a path to append to the database path * @return string * @static */ @@ -254,7 +256,7 @@ public static function databasePath($path = '') /** * Set the database directory. * - * @param string $path + * @param string $path * @return \Zhiyi\Plus\Application * @static */ @@ -303,7 +305,7 @@ public static function storagePath() /** * Set the storage directory. * - * @param string $path + * @param string $path * @return \Zhiyi\Plus\Application * @static */ @@ -316,7 +318,7 @@ public static function useStoragePath($path) /** * Get the path to the resources directory. * - * @param string $path + * @param string $path * @return string * @static */ @@ -341,7 +343,7 @@ public static function environmentPath() /** * Set the directory for the environment file. * - * @param string $path + * @param string $path * @return \Zhiyi\Plus\Application * @static */ @@ -354,7 +356,7 @@ public static function useEnvironmentPath($path) /** * Set the environment file to be loaded during bootstrapping. * - * @param string $file + * @param string $file * @return \Zhiyi\Plus\Application * @static */ @@ -391,7 +393,7 @@ public static function environmentFilePath() /** * Get or check the current application environment. * - * @param string|array $environments + * @param string|array $environments * @return string|bool * @static */ @@ -428,7 +430,7 @@ public static function isProduction() /** * Detect the application's current environment. * - * @param \Closure $callback + * @param \Closure $callback * @return string * @static */ @@ -477,8 +479,8 @@ public static function registerConfiguredProviders() /** * Register a service provider with the application. * - * @param \Illuminate\Support\ServiceProvider|string $provider - * @param bool $force + * @param \Illuminate\Support\ServiceProvider|string $provider + * @param bool $force * @return \Illuminate\Support\ServiceProvider * @static */ @@ -491,7 +493,7 @@ public static function register($provider, $force = false) /** * Get the registered service provider instance if it exists. * - * @param \Illuminate\Support\ServiceProvider|string $provider + * @param \Illuminate\Support\ServiceProvider|string $provider * @return \Illuminate\Support\ServiceProvider|null * @static */ @@ -504,7 +506,7 @@ public static function getProvider($provider) /** * Get the registered service provider instances if any exist. * - * @param \Illuminate\Support\ServiceProvider|string $provider + * @param \Illuminate\Support\ServiceProvider|string $provider * @return array * @static */ @@ -517,7 +519,7 @@ public static function getProviders($provider) /** * Resolve a service provider instance from the class name. * - * @param string $provider + * @param string $provider * @return \Illuminate\Support\ServiceProvider * @static */ @@ -542,7 +544,7 @@ public static function loadDeferredProviders() /** * Load the provider for a deferred service. * - * @param string $service + * @param string $service * @return void * @static */ @@ -555,8 +557,8 @@ public static function loadDeferredProvider($service) /** * Register a deferred provider and service. * - * @param string $provider - * @param string|null $service + * @param string $provider + * @param string|null $service * @return void * @static */ @@ -569,8 +571,8 @@ public static function registerDeferredProvider($provider, $service = null) /** * Resolve the given type from the container. * - * @param string $abstract - * @param array $parameters + * @param string $abstract + * @param array $parameters * @return mixed * @static */ @@ -583,7 +585,7 @@ public static function make($abstract, $parameters = []) /** * Determine if the given abstract type has been bound. * - * @param string $abstract + * @param string $abstract * @return bool * @static */ @@ -620,7 +622,7 @@ public static function boot() /** * Register a new boot listener. * - * @param callable $callback + * @param callable $callback * @return void * @static */ @@ -633,7 +635,7 @@ public static function booting($callback) /** * Register a new "booted" listener. * - * @param callable $callback + * @param callable $callback * @return void * @static */ @@ -763,7 +765,7 @@ public static function getCachedEventsPath() /** * Add new prefix to list of absolute path prefixes. * - * @param string $prefix + * @param string $prefix * @return \Zhiyi\Plus\Application * @static */ @@ -788,10 +790,11 @@ public static function isDownForMaintenance() /** * Throw an HttpException with the given data. * - * @param int $code - * @param string $message - * @param array $headers + * @param int $code + * @param string $message + * @param array $headers * @return void + * * @throws \Symfony\Component\HttpKernel\Exception\HttpException * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException * @static @@ -805,7 +808,7 @@ public static function abort($code, $message = '', $headers = []) /** * Register a terminating callback with the application. * - * @param callable|string $callback + * @param callable|string $callback * @return \Zhiyi\Plus\Application * @static */ @@ -842,7 +845,7 @@ public static function getLoadedProviders() /** * Determine if the given service provider is loaded. * - * @param string $provider + * @param string $provider * @return bool * @static */ @@ -867,7 +870,7 @@ public static function getDeferredServices() /** * Set the application's deferred services. * - * @param array $services + * @param array $services * @return void * @static */ @@ -880,7 +883,7 @@ public static function setDeferredServices($services) /** * Add an array of services to the application's deferred services. * - * @param array $services + * @param array $services * @return void * @static */ @@ -893,7 +896,7 @@ public static function addDeferredServices($services) /** * Determine if the given service is a deferred service. * - * @param string $service + * @param string $service * @return bool * @static */ @@ -906,7 +909,7 @@ public static function isDeferredService($service) /** * Configure the real-time facade namespace. * - * @param string $namespace + * @param string $namespace * @return void * @static */ @@ -943,7 +946,7 @@ public static function getFallbackLocale() /** * Set the current application locale. * - * @param string $locale + * @param string $locale * @return void * @static */ @@ -956,7 +959,7 @@ public static function setLocale($locale) /** * Set the current application fallback locale. * - * @param string $fallbackLocale + * @param string $fallbackLocale * @return void * @static */ @@ -969,7 +972,7 @@ public static function setFallbackLocale($fallbackLocale) /** * Determine if application locale is the given locale. * - * @param string $locale + * @param string $locale * @return bool * @static */ @@ -995,6 +998,7 @@ public static function flush() * Get the application namespace. * * @return string + * * @throws \RuntimeException * @static */ @@ -1007,7 +1011,7 @@ public static function getNamespace() /** * Define a contextual binding. * - * @param array|string $concrete + * @param array|string $concrete * @return \Illuminate\Contracts\Container\ContextualBindingBuilder * @static */ @@ -1025,7 +1029,7 @@ public static function when($concrete) * `has($id)` returning true does not mean that `get($id)` will not throw an exception. * It does however mean that `get($id)` will not throw a `NotFoundExceptionInterface`. * - * @param string $id Identifier of the entry to look for. + * @param string $id Identifier of the entry to look for. * @return bool * @static */ @@ -1038,7 +1042,7 @@ public static function has($id) /** * Determine if the given abstract type has been resolved. * - * @param string $abstract + * @param string $abstract * @return bool * @static */ @@ -1051,7 +1055,7 @@ public static function resolved($abstract) /** * Determine if a given type is shared. * - * @param string $abstract + * @param string $abstract * @return bool * @static */ @@ -1064,7 +1068,7 @@ public static function isShared($abstract) /** * Determine if a given string is an alias. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -1077,9 +1081,9 @@ public static function isAlias($name) /** * Register a binding with the container. * - * @param string $abstract - * @param \Closure|string|null $concrete - * @param bool $shared + * @param string $abstract + * @param \Closure|string|null $concrete + * @param bool $shared * @return void * @static */ @@ -1092,7 +1096,7 @@ public static function bind($abstract, $concrete = null, $shared = false) /** * Determine if the container has a method binding. * - * @param string $method + * @param string $method * @return bool * @static */ @@ -1105,8 +1109,8 @@ public static function hasMethodBinding($method) /** * Bind a callback to resolve with Container::call. * - * @param array|string $method - * @param \Closure $callback + * @param array|string $method + * @param \Closure $callback * @return void * @static */ @@ -1119,8 +1123,8 @@ public static function bindMethod($method, $callback) /** * Get the method binding for the given method. * - * @param string $method - * @param mixed $instance + * @param string $method + * @param mixed $instance * @return mixed * @static */ @@ -1133,9 +1137,9 @@ public static function callMethodBinding($method, $instance) /** * Add a contextual binding to the container. * - * @param string $concrete - * @param string $abstract - * @param \Closure|string $implementation + * @param string $concrete + * @param string $abstract + * @param \Closure|string $implementation * @return void * @static */ @@ -1148,9 +1152,9 @@ public static function addContextualBinding($concrete, $abstract, $implementatio /** * Register a binding if it hasn't already been registered. * - * @param string $abstract - * @param \Closure|string|null $concrete - * @param bool $shared + * @param string $abstract + * @param \Closure|string|null $concrete + * @param bool $shared * @return void * @static */ @@ -1163,8 +1167,8 @@ public static function bindIf($abstract, $concrete = null, $shared = false) /** * Register a shared binding in the container. * - * @param string $abstract - * @param \Closure|string|null $concrete + * @param string $abstract + * @param \Closure|string|null $concrete * @return void * @static */ @@ -1177,8 +1181,8 @@ public static function singleton($abstract, $concrete = null) /** * Register a shared binding if it hasn't already been registered. * - * @param string $abstract - * @param \Closure|string|null $concrete + * @param string $abstract + * @param \Closure|string|null $concrete * @return void * @static */ @@ -1191,9 +1195,10 @@ public static function singletonIf($abstract, $concrete = null) /** * "Extend" an abstract type in the container. * - * @param string $abstract - * @param \Closure $closure + * @param string $abstract + * @param \Closure $closure * @return void + * * @throws \InvalidArgumentException * @static */ @@ -1206,8 +1211,8 @@ public static function extend($abstract, $closure) /** * Register an existing instance as shared in the container. * - * @param string $abstract - * @param mixed $instance + * @param string $abstract + * @param mixed $instance * @return mixed * @static */ @@ -1220,8 +1225,8 @@ public static function instance($abstract, $instance) /** * Assign a set of tags to a given binding. * - * @param array|string $abstracts - * @param array|mixed $tags + * @param array|string $abstracts + * @param array|mixed $tags * @return void * @static */ @@ -1234,7 +1239,7 @@ public static function tag($abstracts, $tags) /** * Resolve all of the bindings for a given tag. * - * @param string $tag + * @param string $tag * @return \Illuminate\Container\iterable * @static */ @@ -1247,9 +1252,10 @@ public static function tagged($tag) /** * Alias a type to a different name. * - * @param string $abstract - * @param string $alias + * @param string $abstract + * @param string $alias * @return void + * * @throws \LogicException * @static */ @@ -1262,8 +1268,8 @@ public static function alias($abstract, $alias) /** * Bind a new callback to an abstract's rebind event. * - * @param string $abstract - * @param \Closure $callback + * @param string $abstract + * @param \Closure $callback * @return mixed * @static */ @@ -1276,9 +1282,9 @@ public static function rebinding($abstract, $callback) /** * Refresh an instance on the given target and method. * - * @param string $abstract - * @param mixed $target - * @param string $method + * @param string $abstract + * @param mixed $target + * @param string $method * @return mixed * @static */ @@ -1291,8 +1297,8 @@ public static function refresh($abstract, $target, $method) /** * Wrap the given closure such that its dependencies will be injected when executed. * - * @param \Closure $callback - * @param array $parameters + * @param \Closure $callback + * @param array $parameters * @return \Closure * @static */ @@ -1305,10 +1311,11 @@ public static function wrap($callback, $parameters = []) /** * Call the given Closure / class@method and inject its dependencies. * - * @param callable|string $callback - * @param \Illuminate\Container\array $parameters - * @param string|null $defaultMethod + * @param callable|string $callback + * @param \Illuminate\Container\array $parameters + * @param string|null $defaultMethod * @return mixed + * * @throws \InvalidArgumentException * @static */ @@ -1321,7 +1328,7 @@ public static function call($callback, $parameters = [], $defaultMethod = null) /** * Get a closure to resolve the given type from the container. * - * @param string $abstract + * @param string $abstract * @return \Closure * @static */ @@ -1334,9 +1341,10 @@ public static function factory($abstract) /** * An alias function name for make(). * - * @param string $abstract - * @param array $parameters + * @param string $abstract + * @param array $parameters * @return mixed + * * @throws \Illuminate\Contracts\Container\BindingResolutionException * @static */ @@ -1349,10 +1357,11 @@ public static function makeWith($abstract, $parameters = []) /** * Finds an entry of the container by its identifier and returns it. * - * @param string $id Identifier of the entry to look for. - * @throws NotFoundExceptionInterface No entry was found for **this** identifier. - * @throws ContainerExceptionInterface Error while retrieving the entry. + * @param string $id Identifier of the entry to look for. * @return mixed Entry. + * + * @throws NotFoundExceptionInterface No entry was found for **this** identifier. + * @throws ContainerExceptionInterface Error while retrieving the entry. * @static */ public static function get($id) @@ -1364,8 +1373,9 @@ public static function get($id) /** * Instantiate a concrete instance of the given type. * - * @param \Closure|string $concrete + * @param \Closure|string $concrete * @return mixed + * * @throws \Illuminate\Contracts\Container\BindingResolutionException * @static */ @@ -1378,8 +1388,8 @@ public static function build($concrete) /** * Register a new resolving callback. * - * @param \Closure|string $abstract - * @param \Closure|null $callback + * @param \Closure|string $abstract + * @param \Closure|null $callback * @return void * @static */ @@ -1392,8 +1402,8 @@ public static function resolving($abstract, $callback = null) /** * Register a new after resolving callback for all types. * - * @param \Closure|string $abstract - * @param \Closure|null $callback + * @param \Closure|string $abstract + * @param \Closure|null $callback * @return void * @static */ @@ -1418,7 +1428,7 @@ public static function getBindings() /** * Get the alias for an abstract if available. * - * @param string $abstract + * @param string $abstract * @return string * @static */ @@ -1431,7 +1441,7 @@ public static function getAlias($abstract) /** * Remove all of the extender callbacks for a given type. * - * @param string $abstract + * @param string $abstract * @return void * @static */ @@ -1444,7 +1454,7 @@ public static function forgetExtenders($abstract) /** * Remove a resolved instance from the instance cache. * - * @param string $abstract + * @param string $abstract * @return void * @static */ @@ -1480,7 +1490,7 @@ public static function getInstance() /** * Set the shared instance of the container. * - * @param \Illuminate\Contracts\Container\Container|null $container + * @param \Illuminate\Contracts\Container\Container|null $container * @return \Illuminate\Contracts\Container\Container|static * @static */ @@ -1492,7 +1502,7 @@ public static function setInstance($container = null) /** * Determine if a given offset exists. * - * @param string $key + * @param string $key * @return bool * @static */ @@ -1505,7 +1515,7 @@ public static function offsetExists($key) /** * Get the value at a given offset. * - * @param string $key + * @param string $key * @return mixed * @static */ @@ -1518,8 +1528,8 @@ public static function offsetGet($key) /** * Set the value at a given offset. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value * @return void * @static */ @@ -1532,7 +1542,7 @@ public static function offsetSet($key, $value) /** * Unset the value at a given offset. * - * @param string $key + * @param string $key * @return void * @static */ @@ -1550,8 +1560,8 @@ class Artisan /** * Run the console application. * - * @param \Symfony\Component\Console\Input\InputInterface $input - * @param \Symfony\Component\Console\Output\OutputInterface|null $output + * @param \Symfony\Component\Console\Input\InputInterface $input + * @param \Symfony\Component\Console\Output\OutputInterface|null $output * @return int * @static */ @@ -1564,8 +1574,8 @@ public static function handle($input, $output = null) /** * Terminate the application. * - * @param \Symfony\Component\Console\Input\InputInterface $input - * @param int $status + * @param \Symfony\Component\Console\Input\InputInterface $input + * @param int $status * @return void * @static */ @@ -1578,8 +1588,8 @@ public static function terminate($input, $status) /** * Register a Closure based command with the application. * - * @param string $signature - * @param \Closure $callback + * @param string $signature + * @param \Closure $callback * @return \Illuminate\Foundation\Console\ClosureCommand * @static */ @@ -1592,7 +1602,7 @@ public static function command($signature, $callback) /** * Register the given command with the console application. * - * @param \Symfony\Component\Console\Command\Command $command + * @param \Symfony\Component\Console\Command\Command $command * @return void * @static */ @@ -1605,10 +1615,11 @@ public static function registerCommand($command) /** * Run an Artisan console command by name. * - * @param string $command - * @param array $parameters - * @param \Symfony\Component\Console\Output\OutputInterface|null $outputBuffer + * @param string $command + * @param array $parameters + * @param \Symfony\Component\Console\Output\OutputInterface|null $outputBuffer * @return int + * * @throws \Symfony\Component\Console\Exception\CommandNotFoundException * @static */ @@ -1621,8 +1632,8 @@ public static function call($command, $parameters = [], $outputBuffer = null) /** * Queue the given console command. * - * @param string $command - * @param array $parameters + * @param string $command + * @param array $parameters * @return \Illuminate\Foundation\Bus\PendingDispatch * @static */ @@ -1671,7 +1682,7 @@ public static function bootstrap() /** * Set the Artisan application instance. * - * @param \Illuminate\Console\Application $artisan + * @param \Illuminate\Console\Application $artisan * @return void * @static */ @@ -1692,7 +1703,7 @@ class Auth /** * Attempt to get the guard from the local cache. * - * @param string|null $name + * @param string|null $name * @return \Illuminate\Contracts\Auth\Guard|\Illuminate\Contracts\Auth\StatefulGuard * @static */ @@ -1705,8 +1716,8 @@ public static function guard($name = null) /** * Create a session based authentication guard. * - * @param string $name - * @param array $config + * @param string $name + * @param array $config * @return \Illuminate\Auth\SessionGuard * @static */ @@ -1719,8 +1730,8 @@ public static function createSessionDriver($name, $config) /** * Create a token based authentication guard. * - * @param string $name - * @param array $config + * @param string $name + * @param array $config * @return \Illuminate\Auth\TokenGuard * @static */ @@ -1745,7 +1756,7 @@ public static function getDefaultDriver() /** * Set the default guard driver the factory should serve. * - * @param string $name + * @param string $name * @return void * @static */ @@ -1758,7 +1769,7 @@ public static function shouldUse($name) /** * Set the default authentication driver name. * - * @param string $name + * @param string $name * @return void * @static */ @@ -1771,8 +1782,8 @@ public static function setDefaultDriver($name) /** * Register a new callback based request guard. * - * @param string $driver - * @param callable $callback + * @param string $driver + * @param callable $callback * @return \Illuminate\Auth\AuthManager * @static */ @@ -1797,7 +1808,7 @@ public static function userResolver() /** * Set the callback to be used to resolve users. * - * @param \Closure $userResolver + * @param \Closure $userResolver * @return \Illuminate\Auth\AuthManager * @static */ @@ -1810,8 +1821,8 @@ public static function resolveUsersUsing($userResolver) /** * Register a custom driver creator Closure. * - * @param string $driver - * @param \Closure $callback + * @param string $driver + * @param \Closure $callback * @return \Illuminate\Auth\AuthManager * @static */ @@ -1824,8 +1835,8 @@ public static function extend($driver, $callback) /** * Register a custom provider creator Closure. * - * @param string $name - * @param \Closure $callback + * @param string $name + * @param \Closure $callback * @return \Illuminate\Auth\AuthManager * @static */ @@ -1850,8 +1861,9 @@ public static function hasResolvedGuards() /** * Create the user provider implementation for the driver. * - * @param string|null $provider + * @param string|null $provider * @return \Illuminate\Contracts\Auth\UserProvider|null + * * @throws \InvalidArgumentException * @static */ @@ -1900,7 +1912,7 @@ public static function id() /** * Log a user into the application without sessions or cookies. * - * @param array $credentials + * @param array $credentials * @return bool * @static */ @@ -1913,7 +1925,7 @@ public static function once($credentials = []) /** * Log the given user ID into the application without sessions or cookies. * - * @param mixed $id + * @param mixed $id * @return \Zhiyi\Plus\Models\User|false * @static */ @@ -1926,7 +1938,7 @@ public static function onceUsingId($id) /** * Validate a user's credentials. * - * @param array $credentials + * @param array $credentials * @return bool * @static */ @@ -1939,8 +1951,8 @@ public static function validate($credentials = []) /** * Attempt to authenticate using HTTP Basic Auth. * - * @param string $field - * @param array $extraConditions + * @param string $field + * @param array $extraConditions * @return \Symfony\Component\HttpFoundation\Response|null * @static */ @@ -1953,8 +1965,8 @@ public static function basic($field = 'email', $extraConditions = []) /** * Perform a stateless HTTP Basic login attempt. * - * @param string $field - * @param array $extraConditions + * @param string $field + * @param array $extraConditions * @return \Symfony\Component\HttpFoundation\Response|null * @static */ @@ -1967,8 +1979,8 @@ public static function onceBasic($field = 'email', $extraConditions = []) /** * Attempt to authenticate a user using the given credentials. * - * @param array $credentials - * @param bool $remember + * @param array $credentials + * @param bool $remember * @return bool * @static */ @@ -1981,8 +1993,8 @@ public static function attempt($credentials = [], $remember = false) /** * Log the given user ID into the application. * - * @param mixed $id - * @param bool $remember + * @param mixed $id + * @param bool $remember * @return \Zhiyi\Plus\Models\User|false * @static */ @@ -1995,8 +2007,8 @@ public static function loginUsingId($id, $remember = false) /** * Log a user into the application. * - * @param \Illuminate\Contracts\Auth\Authenticatable $user - * @param bool $remember + * @param \Illuminate\Contracts\Auth\Authenticatable $user + * @param bool $remember * @return void * @static */ @@ -2037,8 +2049,8 @@ public static function logoutCurrentDevice() * * The application must be using the AuthenticateSession middleware. * - * @param string $password - * @param string $attribute + * @param string $password + * @param string $attribute * @return bool|null * @static */ @@ -2051,7 +2063,7 @@ public static function logoutOtherDevices($password, $attribute = 'password') /** * Register an authentication attempt event listener. * - * @param mixed $callback + * @param mixed $callback * @return void * @static */ @@ -2113,6 +2125,7 @@ public static function viaRemember() * Get the cookie creator instance used by the guard. * * @return \Illuminate\Contracts\Cookie\QueueingFactory + * * @throws \RuntimeException * @static */ @@ -2125,7 +2138,7 @@ public static function getCookieJar() /** * Set the cookie creator instance used by the guard. * - * @param \Illuminate\Contracts\Cookie\QueueingFactory $cookie + * @param \Illuminate\Contracts\Cookie\QueueingFactory $cookie * @return void * @static */ @@ -2150,7 +2163,7 @@ public static function getDispatcher() /** * Set the event dispatcher instance. * - * @param \Illuminate\Contracts\Events\Dispatcher $events + * @param \Illuminate\Contracts\Events\Dispatcher $events * @return void * @static */ @@ -2187,7 +2200,7 @@ public static function getUser() /** * Set the current user. * - * @param \Illuminate\Contracts\Auth\Authenticatable $user + * @param \Illuminate\Contracts\Auth\Authenticatable $user * @return \Illuminate\Auth\SessionGuard * @static */ @@ -2212,7 +2225,7 @@ public static function getRequest() /** * Set the current request instance. * - * @param \Symfony\Component\HttpFoundation\Request $request + * @param \Symfony\Component\HttpFoundation\Request $request * @return \Illuminate\Auth\SessionGuard * @static */ @@ -2226,6 +2239,7 @@ public static function setRequest($request) * Determine if current user is authenticated. If not, throw an exception. * * @return \Zhiyi\Plus\Models\User + * * @throws \Illuminate\Auth\AuthenticationException * @static */ @@ -2286,7 +2300,7 @@ public static function getProvider() /** * Set the user provider used by the guard. * - * @param \Illuminate\Contracts\Auth\UserProvider $provider + * @param \Illuminate\Contracts\Auth\UserProvider $provider * @return void * @static */ @@ -2299,8 +2313,8 @@ public static function setProvider($provider) /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -2312,9 +2326,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -2326,7 +2341,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -2343,7 +2358,7 @@ class Blade /** * Compile the view at the given path. * - * @param string|null $path + * @param string|null $path * @return void * @static */ @@ -2368,7 +2383,7 @@ public static function getPath() /** * Set the path currently being compiled. * - * @param string $path + * @param string $path * @return void * @static */ @@ -2381,7 +2396,7 @@ public static function setPath($path) /** * Compile the given Blade template contents. * - * @param string $value + * @param string $value * @return string * @static */ @@ -2394,7 +2409,7 @@ public static function compileString($value) /** * Strip the parentheses from the given expression. * - * @param string $expression + * @param string $expression * @return string * @static */ @@ -2407,7 +2422,7 @@ public static function stripParentheses($expression) /** * Register a custom Blade compiler. * - * @param callable $compiler + * @param callable $compiler * @return void * @static */ @@ -2432,8 +2447,8 @@ public static function getExtensions() /** * Register an "if" statement directive. * - * @param string $name - * @param callable $callback + * @param string $name + * @param callable $callback * @return void * @static */ @@ -2446,8 +2461,8 @@ public static function if($name, $callback) /** * Check the result of a condition. * - * @param string $name - * @param array $parameters + * @param string $name + * @param array $parameters * @return bool * @static */ @@ -2460,9 +2475,9 @@ public static function check($name, ...$parameters) /** * Register a class-based component alias directive. * - * @param string $class - * @param string|null $alias - * @param string $prefix + * @param string $class + * @param string|null $alias + * @param string $prefix * @return void * @static */ @@ -2475,8 +2490,8 @@ public static function component($class, $alias = null, $prefix = '') /** * Register an array of class-based components. * - * @param array $components - * @param string $prefix + * @param array $components + * @param string $prefix * @return void * @static */ @@ -2501,8 +2516,8 @@ public static function getClassComponentAliases() /** * Register a class-based component namespace. * - * @param string $namespace - * @param string $prefix + * @param string $namespace + * @param string $prefix * @return void * @static */ @@ -2527,8 +2542,8 @@ public static function getClassComponentNamespaces() /** * Register a component alias directive. * - * @param string $path - * @param string|null $alias + * @param string $path + * @param string|null $alias * @return void * @static */ @@ -2541,8 +2556,8 @@ public static function aliasComponent($path, $alias = null) /** * Register an include alias directive. * - * @param string $path - * @param string|null $alias + * @param string $path + * @param string|null $alias * @return void * @static */ @@ -2555,8 +2570,8 @@ public static function include($path, $alias = null) /** * Register an include alias directive. * - * @param string $path - * @param string|null $alias + * @param string $path + * @param string|null $alias * @return void * @static */ @@ -2569,9 +2584,10 @@ public static function aliasInclude($path, $alias = null) /** * Register a handler for custom directives. * - * @param string $name - * @param callable $handler + * @param string $name + * @param callable $handler * @return void + * * @throws \InvalidArgumentException * @static */ @@ -2596,7 +2612,7 @@ public static function getCustomDirectives() /** * Register a new precompiler. * - * @param callable $precompiler + * @param callable $precompiler * @return void * @static */ @@ -2609,7 +2625,7 @@ public static function precompiler($precompiler) /** * Set the echo format to be used by the compiler. * - * @param string $format + * @param string $format * @return void * @static */ @@ -2658,7 +2674,7 @@ public static function withoutComponentTags() /** * Get the path to the compiled version of a view. * - * @param string $path + * @param string $path * @return string * @static */ @@ -2671,7 +2687,7 @@ public static function getCompiledPath($path) /** * Determine if the view at the given path is expired. * - * @param string $path + * @param string $path * @return bool * @static */ @@ -2684,7 +2700,7 @@ public static function isExpired($path) /** * Get a new component hash for a component name. * - * @param string $component + * @param string $component * @return string * @static */ @@ -2696,10 +2712,10 @@ public static function newComponentHash($component) /** * Compile a class component opening. * - * @param string $component - * @param string $alias - * @param string $data - * @param string $hash + * @param string $component + * @param string $alias + * @param string $data + * @param string $hash * @return string * @static */ @@ -2723,7 +2739,7 @@ public static function compileEndComponentClass() /** * Sanitize the given component attribute value. * - * @param mixed $value + * @param mixed $value * @return mixed * @static */ @@ -2747,7 +2763,7 @@ public static function compileEndOnce() /** * Compile Blade echos into valid PHP. * - * @param string $value + * @param string $value * @return string * @static */ @@ -2760,6 +2776,7 @@ public static function compileEchos($value) /** * @method static \Illuminate\Broadcasting\Broadcasters\Broadcaster channel(string $channel, callable|string $callback, array $options = []) * @method static mixed auth(\Illuminate\Http\Request $request) + * * @see \Illuminate\Contracts\Broadcasting\Factory */ class Broadcast @@ -2767,7 +2784,7 @@ class Broadcast /** * Register the routes for handling broadcast authentication and sockets. * - * @param array|null $attributes + * @param array|null $attributes * @return void * @static */ @@ -2780,7 +2797,7 @@ public static function routes($attributes = null) /** * Get the socket ID for the given request. * - * @param \Illuminate\Http\Request|null $request + * @param \Illuminate\Http\Request|null $request * @return string|null * @static */ @@ -2793,7 +2810,7 @@ public static function socket($request = null) /** * Begin broadcasting an event. * - * @param mixed|null $event + * @param mixed|null $event * @return \Illuminate\Broadcasting\PendingBroadcast * @static */ @@ -2806,7 +2823,7 @@ public static function event($event = null) /** * Queue the given event for broadcast. * - * @param mixed $event + * @param mixed $event * @return void * @static */ @@ -2819,7 +2836,7 @@ public static function queue($event) /** * Get a driver instance. * - * @param string|null $driver + * @param string|null $driver * @return mixed * @static */ @@ -2832,7 +2849,7 @@ public static function connection($driver = null) /** * Get a driver instance. * - * @param string|null $name + * @param string|null $name * @return mixed * @static */ @@ -2857,7 +2874,7 @@ public static function getDefaultDriver() /** * Set the default driver name. * - * @param string $name + * @param string $name * @return void * @static */ @@ -2870,7 +2887,7 @@ public static function setDefaultDriver($name) /** * Disconnect the given disk and remove from local cache. * - * @param string|null $name + * @param string|null $name * @return void * @static */ @@ -2883,8 +2900,8 @@ public static function purge($name = null) /** * Register a custom driver creator Closure. * - * @param string $driver - * @param \Closure $callback + * @param string $driver + * @param \Closure $callback * @return \Illuminate\Broadcasting\BroadcastManager * @static */ @@ -2902,7 +2919,7 @@ class Bus /** * Dispatch a command to its appropriate handler. * - * @param mixed $command + * @param mixed $command * @return mixed * @static */ @@ -2917,8 +2934,8 @@ public static function dispatch($command) * * Queuable jobs will be dispatched to the "sync" queue. * - * @param mixed $command - * @param mixed $handler + * @param mixed $command + * @param mixed $handler * @return mixed * @static */ @@ -2931,8 +2948,8 @@ public static function dispatchSync($command, $handler = null) /** * Dispatch a command to its appropriate handler in the current process without using the synchronous queue. * - * @param mixed $command - * @param mixed $handler + * @param mixed $command + * @param mixed $handler * @return mixed * @static */ @@ -2945,7 +2962,7 @@ public static function dispatchNow($command, $handler = null) /** * Attempt to find the batch with the given ID. * - * @param string $batchId + * @param string $batchId * @return \Illuminate\Bus\Batch|null * @static */ @@ -2958,7 +2975,7 @@ public static function findBatch($batchId) /** * Create a new batch of queueable jobs. * - * @param \Illuminate\Support\Collection|array|mixed $jobs + * @param \Illuminate\Support\Collection|array|mixed $jobs * @return \Illuminate\Bus\PendingBatch * @static */ @@ -2971,7 +2988,7 @@ public static function batch($jobs) /** * Create a new chain of queueable jobs. * - * @param \Illuminate\Support\Collection|array $jobs + * @param \Illuminate\Support\Collection|array $jobs * @return \Illuminate\Foundation\Bus\PendingChain * @static */ @@ -2984,7 +3001,7 @@ public static function chain($jobs) /** * Determine if the given command has a handler. * - * @param mixed $command + * @param mixed $command * @return bool * @static */ @@ -2997,7 +3014,7 @@ public static function hasCommandHandler($command) /** * Retrieve the handler for a command. * - * @param mixed $command + * @param mixed $command * @return bool|mixed * @static */ @@ -3010,7 +3027,7 @@ public static function getCommandHandler($command) /** * Dispatch a command to its appropriate handler behind a queue. * - * @param mixed $command + * @param mixed $command * @return mixed * @static */ @@ -3023,8 +3040,8 @@ public static function dispatchToQueue($command) /** * Dispatch a command to its appropriate handler after the current process. * - * @param mixed $command - * @param mixed $handler + * @param mixed $command + * @param mixed $handler * @return void * @static */ @@ -3037,7 +3054,7 @@ public static function dispatchAfterResponse($command, $handler = null) /** * Set the pipes through which commands should be piped before dispatching. * - * @param array $pipes + * @param array $pipes * @return \Illuminate\Bus\Dispatcher * @static */ @@ -3050,7 +3067,7 @@ public static function pipeThrough($pipes) /** * Map a command to a handler. * - * @param array $map + * @param array $map * @return \Illuminate\Bus\Dispatcher * @static */ @@ -3063,8 +3080,8 @@ public static function map($map) /** * Assert if a job was dispatched based on a truth-test callback. * - * @param string|\Closure $command - * @param callable|int|null $callback + * @param string|\Closure $command + * @param callable|int|null $callback * @return void * @static */ @@ -3077,8 +3094,8 @@ public static function assertDispatched($command, $callback = null) /** * Assert if a job was pushed a number of times. * - * @param string $command - * @param int $times + * @param string $command + * @param int $times * @return void * @static */ @@ -3091,8 +3108,8 @@ public static function assertDispatchedTimes($command, $times = 1) /** * Determine if a job was dispatched based on a truth-test callback. * - * @param string|\Closure $command - * @param callable|null $callback + * @param string|\Closure $command + * @param callable|null $callback * @return void * @static */ @@ -3105,8 +3122,8 @@ public static function assertNotDispatched($command, $callback = null) /** * Assert if a job was dispatched after the response was sent based on a truth-test callback. * - * @param string|\Closure $command - * @param callable|int|null $callback + * @param string|\Closure $command + * @param callable|int|null $callback * @return void * @static */ @@ -3119,8 +3136,8 @@ public static function assertDispatchedAfterResponse($command, $callback = null) /** * Assert if a job was pushed after the response was sent a number of times. * - * @param string $command - * @param int $times + * @param string $command + * @param int $times * @return void * @static */ @@ -3133,8 +3150,8 @@ public static function assertDispatchedAfterResponseTimes($command, $times = 1) /** * Determine if a job was dispatched based on a truth-test callback. * - * @param string|\Closure $command - * @param callable|null $callback + * @param string|\Closure $command + * @param callable|null $callback * @return void * @static */ @@ -3147,7 +3164,7 @@ public static function assertNotDispatchedAfterResponse($command, $callback = nu /** * Assert if a batch was dispatched based on a truth-test callback. * - * @param callable $callback + * @param callable $callback * @return void * @static */ @@ -3160,8 +3177,8 @@ public static function assertBatched($callback) /** * Get all of the jobs matching a truth-test callback. * - * @param string $command - * @param callable|null $callback + * @param string $command + * @param callable|null $callback * @return \Illuminate\Support\Collection * @static */ @@ -3174,8 +3191,8 @@ public static function dispatched($command, $callback = null) /** * Get all of the jobs dispatched after the response was sent matching a truth-test callback. * - * @param string $command - * @param callable|null $callback + * @param string $command + * @param callable|null $callback * @return \Illuminate\Support\Collection * @static */ @@ -3188,7 +3205,7 @@ public static function dispatchedAfterResponse($command, $callback = null) /** * Get all of the pending batches matching a truth-test callback. * - * @param callable $callback + * @param callable $callback * @return \Illuminate\Support\Collection * @static */ @@ -3201,7 +3218,7 @@ public static function batched($callback) /** * Determine if there are any stored commands for a given class. * - * @param string $command + * @param string $command * @return bool * @static */ @@ -3214,7 +3231,7 @@ public static function hasDispatched($command) /** * Determine if there are any stored commands for a given class. * - * @param string $command + * @param string $command * @return bool * @static */ @@ -3227,7 +3244,7 @@ public static function hasDispatchedAfterResponse($command) /** * Record the fake pending batch dispatch. * - * @param \Illuminate\Bus\PendingBatch $pendingBatch + * @param \Illuminate\Bus\PendingBatch $pendingBatch * @return \Illuminate\Bus\Batch * @static */ @@ -3246,7 +3263,7 @@ class Cache /** * Get a cache store instance by name, wrapped in a repository. * - * @param string|null $name + * @param string|null $name * @return \Illuminate\Contracts\Cache\Repository * @static */ @@ -3259,7 +3276,7 @@ public static function store($name = null) /** * Get a cache driver instance. * - * @param string|null $driver + * @param string|null $driver * @return \Illuminate\Contracts\Cache\Repository * @static */ @@ -3272,7 +3289,7 @@ public static function driver($driver = null) /** * Create a new cache repository with the given implementation. * - * @param \Illuminate\Contracts\Cache\Store $store + * @param \Illuminate\Contracts\Cache\Store $store * @return \Illuminate\Cache\Repository * @static */ @@ -3309,7 +3326,7 @@ public static function getDefaultDriver() /** * Set the default cache driver name. * - * @param string $name + * @param string $name * @return void * @static */ @@ -3322,7 +3339,7 @@ public static function setDefaultDriver($name) /** * Unset the given driver instances. * - * @param array|string|null $name + * @param array|string|null $name * @return \Illuminate\Cache\CacheManager * @static */ @@ -3335,7 +3352,7 @@ public static function forgetDriver($name = null) /** * Disconnect the given driver and remove from local cache. * - * @param string|null $name + * @param string|null $name * @return void * @static */ @@ -3348,8 +3365,8 @@ public static function purge($name = null) /** * Register a custom driver creator Closure. * - * @param string $driver - * @param \Closure $callback + * @param string $driver + * @param \Closure $callback * @return \Illuminate\Cache\CacheManager * @static */ @@ -3362,7 +3379,7 @@ public static function extend($driver, $callback) /** * Determine if an item exists in the cache. * - * @param string $key + * @param string $key * @return bool * @static */ @@ -3375,7 +3392,7 @@ public static function has($key) /** * Determine if an item doesn't exist in the cache. * - * @param string $key + * @param string $key * @return bool * @static */ @@ -3388,8 +3405,8 @@ public static function missing($key) /** * Retrieve an item from the cache by key. * - * @param string $key - * @param mixed $default + * @param string $key + * @param mixed $default * @return mixed * @static */ @@ -3404,7 +3421,7 @@ public static function get($key, $default = null) * * Items not found in the cache will have a null value. * - * @param array $keys + * @param array $keys * @return array * @static */ @@ -3417,12 +3434,13 @@ public static function many($keys) /** * Obtains multiple cache items by their unique keys. * - * @param \Psr\SimpleCache\iterable $keys A list of keys that can obtained in a single operation. - * @param mixed $default Default value to return for keys that do not exist. + * @param \Psr\SimpleCache\iterable $keys A list of keys that can obtained in a single operation. + * @param mixed $default Default value to return for keys that do not exist. * @return \Psr\SimpleCache\iterable A list of key => value pairs. Cache keys that do not exist or are stale will have $default as value. + * * @throws \Psr\SimpleCache\InvalidArgumentException - * MUST be thrown if $keys is neither an array nor a Traversable, - * or if any of the $keys are not a legal value. + * MUST be thrown if $keys is neither an array nor a Traversable, + * or if any of the $keys are not a legal value. * @static */ public static function getMultiple($keys, $default = null) @@ -3434,8 +3452,8 @@ public static function getMultiple($keys, $default = null) /** * Retrieve an item from the cache and delete it. * - * @param string $key - * @param mixed $default + * @param string $key + * @param mixed $default * @return mixed * @static */ @@ -3448,9 +3466,9 @@ public static function pull($key, $default = null) /** * Store an item in the cache. * - * @param string $key - * @param mixed $value - * @param \DateTimeInterface|\DateInterval|int|null $ttl + * @param string $key + * @param mixed $value + * @param \DateTimeInterface|\DateInterval|int|null $ttl * @return bool * @static */ @@ -3463,14 +3481,15 @@ public static function put($key, $value, $ttl = null) /** * Persists data in the cache, uniquely referenced by a key with an optional expiration TTL time. * - * @param string $key The key of the item to store. - * @param mixed $value The value of the item to store, must be serializable. - * @param null|int|\DateInterval $ttl Optional. The TTL value of this item. If no value is sent and - * the driver supports TTL then the library may set a default value - * for it or let the driver take care of that. + * @param string $key The key of the item to store. + * @param mixed $value The value of the item to store, must be serializable. + * @param null|int|\DateInterval $ttl Optional. The TTL value of this item. If no value is sent and + * the driver supports TTL then the library may set a default value + * for it or let the driver take care of that. * @return bool True on success and false on failure. + * * @throws \Psr\SimpleCache\InvalidArgumentException - * MUST be thrown if the $key string is not a legal value. + * MUST be thrown if the $key string is not a legal value. * @static */ public static function set($key, $value, $ttl = null) @@ -3482,8 +3501,8 @@ public static function set($key, $value, $ttl = null) /** * Store multiple items in the cache for a given number of seconds. * - * @param array $values - * @param \DateTimeInterface|\DateInterval|int|null $ttl + * @param array $values + * @param \DateTimeInterface|\DateInterval|int|null $ttl * @return bool * @static */ @@ -3496,14 +3515,15 @@ public static function putMany($values, $ttl = null) /** * Persists a set of key => value pairs in the cache, with an optional TTL. * - * @param \Psr\SimpleCache\iterable $values A list of key => value pairs for a multiple-set operation. - * @param null|int|\DateInterval $ttl Optional. The TTL value of this item. If no value is sent and + * @param \Psr\SimpleCache\iterable $values A list of key => value pairs for a multiple-set operation. + * @param null|int|\DateInterval $ttl Optional. The TTL value of this item. If no value is sent and * the driver supports TTL then the library may set a default value * for it or let the driver take care of that. * @return bool True on success and false on failure. + * * @throws \Psr\SimpleCache\InvalidArgumentException - * MUST be thrown if $values is neither an array nor a Traversable, - * or if any of the $values are not a legal value. + * MUST be thrown if $values is neither an array nor a Traversable, + * or if any of the $values are not a legal value. * @static */ public static function setMultiple($values, $ttl = null) @@ -3515,9 +3535,9 @@ public static function setMultiple($values, $ttl = null) /** * Store an item in the cache if the key does not exist. * - * @param string $key - * @param mixed $value - * @param \DateTimeInterface|\DateInterval|int|null $ttl + * @param string $key + * @param mixed $value + * @param \DateTimeInterface|\DateInterval|int|null $ttl * @return bool * @static */ @@ -3530,8 +3550,8 @@ public static function add($key, $value, $ttl = null) /** * Increment the value of an item in the cache. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value * @return int|bool * @static */ @@ -3544,8 +3564,8 @@ public static function increment($key, $value = 1) /** * Decrement the value of an item in the cache. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value * @return int|bool * @static */ @@ -3558,8 +3578,8 @@ public static function decrement($key, $value = 1) /** * Store an item in the cache indefinitely. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value * @return bool * @static */ @@ -3572,9 +3592,9 @@ public static function forever($key, $value) /** * Get an item from the cache, or execute the given Closure and store the result. * - * @param string $key - * @param \DateTimeInterface|\DateInterval|int|null $ttl - * @param \Closure $callback + * @param string $key + * @param \DateTimeInterface|\DateInterval|int|null $ttl + * @param \Closure $callback * @return mixed * @static */ @@ -3587,8 +3607,8 @@ public static function remember($key, $ttl, $callback) /** * Get an item from the cache, or execute the given Closure and store the result forever. * - * @param string $key - * @param \Closure $callback + * @param string $key + * @param \Closure $callback * @return mixed * @static */ @@ -3601,8 +3621,8 @@ public static function sear($key, $callback) /** * Get an item from the cache, or execute the given Closure and store the result forever. * - * @param string $key - * @param \Closure $callback + * @param string $key + * @param \Closure $callback * @return mixed * @static */ @@ -3615,7 +3635,7 @@ public static function rememberForever($key, $callback) /** * Remove an item from the cache. * - * @param string $key + * @param string $key * @return bool * @static */ @@ -3628,10 +3648,11 @@ public static function forget($key) /** * Delete an item from the cache by its unique key. * - * @param string $key The unique cache key of the item to delete. + * @param string $key The unique cache key of the item to delete. * @return bool True if the item was successfully removed. False if there was an error. + * * @throws \Psr\SimpleCache\InvalidArgumentException - * MUST be thrown if the $key string is not a legal value. + * MUST be thrown if the $key string is not a legal value. * @static */ public static function delete($key) @@ -3643,11 +3664,12 @@ public static function delete($key) /** * Deletes multiple cache items in a single operation. * - * @param \Psr\SimpleCache\iterable $keys A list of string-based keys to be deleted. + * @param \Psr\SimpleCache\iterable $keys A list of string-based keys to be deleted. * @return bool True if the items were successfully removed. False if there was an error. + * * @throws \Psr\SimpleCache\InvalidArgumentException - * MUST be thrown if $keys is neither an array nor a Traversable, - * or if any of the $keys are not a legal value. + * MUST be thrown if $keys is neither an array nor a Traversable, + * or if any of the $keys are not a legal value. * @static */ public static function deleteMultiple($keys) @@ -3671,8 +3693,9 @@ public static function clear() /** * Begin executing a new tags operation if the store supports it. * - * @param array|mixed $names + * @param array|mixed $names * @return \Illuminate\Cache\TaggedCache + * * @throws \BadMethodCallException * @static */ @@ -3709,7 +3732,7 @@ public static function getDefaultCacheTime() /** * Set the default cache time in seconds. * - * @param int|null $seconds + * @param int|null $seconds * @return \Illuminate\Cache\Repository * @static */ @@ -3746,7 +3769,7 @@ public static function getEventDispatcher() /** * Set the event dispatcher instance. * - * @param \Illuminate\Contracts\Events\Dispatcher $events + * @param \Illuminate\Contracts\Events\Dispatcher $events * @return void * @static */ @@ -3759,7 +3782,7 @@ public static function setEventDispatcher($events) /** * Determine if a cached value exists. * - * @param string $key + * @param string $key * @return bool * @static */ @@ -3772,7 +3795,7 @@ public static function offsetExists($key) /** * Retrieve an item from the cache by key. * - * @param string $key + * @param string $key * @return mixed * @static */ @@ -3785,8 +3808,8 @@ public static function offsetGet($key) /** * Store an item in the cache for the default time. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value * @return void * @static */ @@ -3799,7 +3822,7 @@ public static function offsetSet($key, $value) /** * Remove an item from the cache. * - * @param string $key + * @param string $key * @return void * @static */ @@ -3812,8 +3835,8 @@ public static function offsetUnset($key) /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -3825,9 +3848,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -3839,7 +3863,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -3851,9 +3875,10 @@ public static function hasMacro($name) /** * Dynamically handle calls to the class. * - * @param string $method - * @param array $parameters + * @param string $method + * @param array $parameters * @return mixed + * * @throws \BadMethodCallException * @static */ @@ -3866,9 +3891,9 @@ public static function macroCall($method, $parameters) /** * Get a lock instance. * - * @param string $name - * @param int $seconds - * @param string|null $owner + * @param string $name + * @param int $seconds + * @param string|null $owner * @return \Illuminate\Contracts\Cache\Lock * @static */ @@ -3881,8 +3906,8 @@ public static function lock($name, $seconds = 0, $owner = null) /** * Restore a lock instance using the owner identifier. * - * @param string $name - * @param string $owner + * @param string $name + * @param string $owner * @return \Illuminate\Contracts\Cache\Lock * @static */ @@ -3919,7 +3944,7 @@ public static function connection() /** * Set the connection name to be used. * - * @param string $connection + * @param string $connection * @return void * @static */ @@ -3956,7 +3981,7 @@ public static function getPrefix() /** * Set the cache key prefix. * - * @param string $prefix + * @param string $prefix * @return void * @static */ @@ -3974,7 +3999,7 @@ class Config /** * Determine if the given configuration value exists. * - * @param string $key + * @param string $key * @return bool * @static */ @@ -3987,8 +4012,8 @@ public static function has($key) /** * Get the specified configuration value. * - * @param array|string $key - * @param mixed $default + * @param array|string $key + * @param mixed $default * @return mixed * @static */ @@ -4001,7 +4026,7 @@ public static function get($key, $default = null) /** * Get many configuration values. * - * @param array $keys + * @param array $keys * @return array * @static */ @@ -4014,8 +4039,8 @@ public static function getMany($keys) /** * Set a given configuration value. * - * @param array|string $key - * @param mixed $value + * @param array|string $key + * @param mixed $value * @return void * @static */ @@ -4028,8 +4053,8 @@ public static function set($key, $value = null) /** * Prepend a value onto an array configuration value. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value * @return void * @static */ @@ -4042,8 +4067,8 @@ public static function prepend($key, $value) /** * Push a value onto an array configuration value. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value * @return void * @static */ @@ -4068,7 +4093,7 @@ public static function all() /** * Determine if the given configuration option exists. * - * @param string $key + * @param string $key * @return bool * @static */ @@ -4081,7 +4106,7 @@ public static function offsetExists($key) /** * Get a configuration option. * - * @param string $key + * @param string $key * @return mixed * @static */ @@ -4094,8 +4119,8 @@ public static function offsetGet($key) /** * Set a configuration option. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value * @return void * @static */ @@ -4108,7 +4133,7 @@ public static function offsetSet($key, $value) /** * Unset a configuration option. * - * @param string $key + * @param string $key * @return void * @static */ @@ -4126,15 +4151,15 @@ class Cookie /** * Create a new cookie instance. * - * @param string $name - * @param string $value - * @param int $minutes - * @param string|null $path - * @param string|null $domain - * @param bool|null $secure - * @param bool $httpOnly - * @param bool $raw - * @param string|null $sameSite + * @param string $name + * @param string $value + * @param int $minutes + * @param string|null $path + * @param string|null $domain + * @param bool|null $secure + * @param bool $httpOnly + * @param bool $raw + * @param string|null $sameSite * @return \Symfony\Component\HttpFoundation\Cookie * @static */ @@ -4147,14 +4172,14 @@ public static function make($name, $value, $minutes = 0, $path = null, $domain = /** * Create a cookie that lasts "forever" (five years). * - * @param string $name - * @param string $value - * @param string|null $path - * @param string|null $domain - * @param bool|null $secure - * @param bool $httpOnly - * @param bool $raw - * @param string|null $sameSite + * @param string $name + * @param string $value + * @param string|null $path + * @param string|null $domain + * @param bool|null $secure + * @param bool $httpOnly + * @param bool $raw + * @param string|null $sameSite * @return \Symfony\Component\HttpFoundation\Cookie * @static */ @@ -4167,9 +4192,9 @@ public static function forever($name, $value, $path = null, $domain = null, $sec /** * Expire the given cookie. * - * @param string $name - * @param string|null $path - * @param string|null $domain + * @param string $name + * @param string|null $path + * @param string|null $domain * @return \Symfony\Component\HttpFoundation\Cookie * @static */ @@ -4182,8 +4207,8 @@ public static function forget($name, $path = null, $domain = null) /** * Determine if a cookie has been queued. * - * @param string $key - * @param string|null $path + * @param string $key + * @param string|null $path * @return bool * @static */ @@ -4196,9 +4221,9 @@ public static function hasQueued($key, $path = null) /** * Get a queued cookie instance. * - * @param string $key - * @param mixed $default - * @param string|null $path + * @param string $key + * @param mixed $default + * @param string|null $path * @return \Symfony\Component\HttpFoundation\Cookie|null * @static */ @@ -4211,7 +4236,7 @@ public static function queued($key, $default = null, $path = null) /** * Queue a cookie to send with the next response. * - * @param array $parameters + * @param array $parameters * @return void * @static */ @@ -4224,8 +4249,8 @@ public static function queue(...$parameters) /** * Remove a cookie from the queue. * - * @param string $name - * @param string|null $path + * @param string $name + * @param string|null $path * @return void * @static */ @@ -4238,10 +4263,10 @@ public static function unqueue($name, $path = null) /** * Set the default path and domain for the jar. * - * @param string $path - * @param string $domain - * @param bool $secure - * @param string|null $sameSite + * @param string $path + * @param string $domain + * @param bool $secure + * @param string|null $sameSite * @return \Illuminate\Cookie\CookieJar * @static */ @@ -4266,8 +4291,8 @@ public static function getQueuedCookies() /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -4279,9 +4304,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -4293,7 +4319,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -4310,8 +4336,8 @@ class Crypt /** * Determine if the given key and cipher combination is valid. * - * @param string $key - * @param string $cipher + * @param string $key + * @param string $cipher * @return bool * @static */ @@ -4323,7 +4349,7 @@ public static function supported($key, $cipher) /** * Create a new encryption key for the given cipher. * - * @param string $cipher + * @param string $cipher * @return string * @static */ @@ -4335,9 +4361,10 @@ public static function generateKey($cipher) /** * Encrypt the given value. * - * @param mixed $value - * @param bool $serialize + * @param mixed $value + * @param bool $serialize * @return string + * * @throws \Illuminate\Contracts\Encryption\EncryptException * @static */ @@ -4350,8 +4377,9 @@ public static function encrypt($value, $serialize = true) /** * Encrypt a string without serialization. * - * @param string $value + * @param string $value * @return string + * * @throws \Illuminate\Contracts\Encryption\EncryptException * @static */ @@ -4364,9 +4392,10 @@ public static function encryptString($value) /** * Decrypt the given value. * - * @param string $payload - * @param bool $unserialize + * @param string $payload + * @param bool $unserialize * @return mixed + * * @throws \Illuminate\Contracts\Encryption\DecryptException * @static */ @@ -4379,8 +4408,9 @@ public static function decrypt($payload, $unserialize = true) /** * Decrypt the given string without unserialization. * - * @param string $payload + * @param string $payload * @return string + * * @throws \Illuminate\Contracts\Encryption\DecryptException * @static */ @@ -4411,7 +4441,7 @@ class DB /** * Get a database connection instance. * - * @param string|null $name + * @param string|null $name * @return \Illuminate\Database\Connection * @static */ @@ -4424,7 +4454,7 @@ public static function connection($name = null) /** * Disconnect from the given database and remove from local cache. * - * @param string|null $name + * @param string|null $name * @return void * @static */ @@ -4437,7 +4467,7 @@ public static function purge($name = null) /** * Disconnect from the given database. * - * @param string|null $name + * @param string|null $name * @return void * @static */ @@ -4450,7 +4480,7 @@ public static function disconnect($name = null) /** * Reconnect to the given database. * - * @param string|null $name + * @param string|null $name * @return \Illuminate\Database\Connection * @static */ @@ -4463,8 +4493,8 @@ public static function reconnect($name = null) /** * Set the default database connection for the callback execution. * - * @param string $name - * @param callable $callback + * @param string $name + * @param callable $callback * @return mixed * @static */ @@ -4489,7 +4519,7 @@ public static function getDefaultConnection() /** * Set the default connection name. * - * @param string $name + * @param string $name * @return void * @static */ @@ -4526,8 +4556,8 @@ public static function availableDrivers() /** * Register an extension connection resolver. * - * @param string $name - * @param callable $resolver + * @param string $name + * @param callable $resolver * @return void * @static */ @@ -4552,7 +4582,7 @@ public static function getConnections() /** * Set the database reconnector callback. * - * @param callable $reconnector + * @param callable $reconnector * @return void * @static */ @@ -4589,8 +4619,8 @@ public static function getSchemaBuilder() /** * Get the schema state for the connection. * - * @param \Illuminate\Filesystem\Filesystem|null $files - * @param callable|null $processFactory + * @param \Illuminate\Filesystem\Filesystem|null $files + * @param callable|null $processFactory * @return \Illuminate\Database\Schema\MySqlSchemaState * @static */ @@ -4639,8 +4669,8 @@ public static function useDefaultPostProcessor() /** * Begin a fluent query against a database table. * - * @param \Closure|\Illuminate\Database\Query\Builder|string $table - * @param string|null $as + * @param \Closure|\Illuminate\Database\Query\Builder|string $table + * @param string|null $as * @return \Illuminate\Database\Query\Builder * @static */ @@ -4665,9 +4695,9 @@ public static function query() /** * Run a select statement and return a single result. * - * @param string $query - * @param array $bindings - * @param bool $useReadPdo + * @param string $query + * @param array $bindings + * @param bool $useReadPdo * @return mixed * @static */ @@ -4680,8 +4710,8 @@ public static function selectOne($query, $bindings = [], $useReadPdo = true) /** * Run a select statement against the database. * - * @param string $query - * @param array $bindings + * @param string $query + * @param array $bindings * @return array * @static */ @@ -4694,9 +4724,9 @@ public static function selectFromWriteConnection($query, $bindings = []) /** * Run a select statement against the database. * - * @param string $query - * @param array $bindings - * @param bool $useReadPdo + * @param string $query + * @param array $bindings + * @param bool $useReadPdo * @return array * @static */ @@ -4709,9 +4739,9 @@ public static function select($query, $bindings = [], $useReadPdo = true) /** * Run a select statement against the database and returns a generator. * - * @param string $query - * @param array $bindings - * @param bool $useReadPdo + * @param string $query + * @param array $bindings + * @param bool $useReadPdo * @return \Generator * @static */ @@ -4724,8 +4754,8 @@ public static function cursor($query, $bindings = [], $useReadPdo = true) /** * Run an insert statement against the database. * - * @param string $query - * @param array $bindings + * @param string $query + * @param array $bindings * @return bool * @static */ @@ -4738,8 +4768,8 @@ public static function insert($query, $bindings = []) /** * Run an update statement against the database. * - * @param string $query - * @param array $bindings + * @param string $query + * @param array $bindings * @return int * @static */ @@ -4752,8 +4782,8 @@ public static function update($query, $bindings = []) /** * Run a delete statement against the database. * - * @param string $query - * @param array $bindings + * @param string $query + * @param array $bindings * @return int * @static */ @@ -4766,8 +4796,8 @@ public static function delete($query, $bindings = []) /** * Execute an SQL statement and return the boolean result. * - * @param string $query - * @param array $bindings + * @param string $query + * @param array $bindings * @return bool * @static */ @@ -4780,8 +4810,8 @@ public static function statement($query, $bindings = []) /** * Run an SQL statement and get the number of rows affected. * - * @param string $query - * @param array $bindings + * @param string $query + * @param array $bindings * @return int * @static */ @@ -4794,7 +4824,7 @@ public static function affectingStatement($query, $bindings = []) /** * Run a raw, unprepared query against the PDO connection. * - * @param string $query + * @param string $query * @return bool * @static */ @@ -4807,7 +4837,7 @@ public static function unprepared($query) /** * Execute the given callback in "dry run" mode. * - * @param \Closure $callback + * @param \Closure $callback * @return array * @static */ @@ -4820,8 +4850,8 @@ public static function pretend($callback) /** * Bind values to their parameters in the given statement. * - * @param \PDOStatement $statement - * @param array $bindings + * @param \PDOStatement $statement + * @param array $bindings * @return void * @static */ @@ -4834,7 +4864,7 @@ public static function bindValues($statement, $bindings) /** * Prepare the query bindings for execution. * - * @param array $bindings + * @param array $bindings * @return array * @static */ @@ -4847,9 +4877,9 @@ public static function prepareBindings($bindings) /** * Log a query in the connection's query log. * - * @param string $query - * @param array $bindings - * @param float|null $time + * @param string $query + * @param array $bindings + * @param float|null $time * @return void * @static */ @@ -4862,7 +4892,7 @@ public static function logQuery($query, $bindings, $time = null) /** * Register a database query listener with the connection. * - * @param \Closure $callback + * @param \Closure $callback * @return void * @static */ @@ -4875,7 +4905,7 @@ public static function listen($callback) /** * Get a new raw query expression. * - * @param mixed $value + * @param mixed $value * @return \Illuminate\Database\Query\Expression * @static */ @@ -4888,7 +4918,7 @@ public static function raw($value) /** * Indicate if any records have been modified. * - * @param bool $value + * @param bool $value * @return void * @static */ @@ -4913,8 +4943,8 @@ public static function isDoctrineAvailable() /** * Get a Doctrine Schema Column instance. * - * @param string $table - * @param string $column + * @param string $table + * @param string $column * @return \Doctrine\DBAL\Schema\Column * @static */ @@ -4999,7 +5029,7 @@ public static function getRawReadPdo() /** * Set the PDO connection. * - * @param \PDO|\Closure|null $pdo + * @param \PDO|\Closure|null $pdo * @return \Illuminate\Database\MySqlConnection * @static */ @@ -5012,7 +5042,7 @@ public static function setPdo($pdo) /** * Set the PDO connection used for reading. * - * @param \PDO|\Closure|null $pdo + * @param \PDO|\Closure|null $pdo * @return \Illuminate\Database\MySqlConnection * @static */ @@ -5037,7 +5067,7 @@ public static function getName() /** * Get an option from the configuration options. * - * @param string|null $option + * @param string|null $option * @return mixed * @static */ @@ -5074,7 +5104,7 @@ public static function getQueryGrammar() /** * Set the query grammar used by the connection. * - * @param \Illuminate\Database\Query\Grammars\Grammar $grammar + * @param \Illuminate\Database\Query\Grammars\Grammar $grammar * @return \Illuminate\Database\MySqlConnection * @static */ @@ -5099,7 +5129,7 @@ public static function getSchemaGrammar() /** * Set the schema grammar used by the connection. * - * @param \Illuminate\Database\Schema\Grammars\Grammar $grammar + * @param \Illuminate\Database\Schema\Grammars\Grammar $grammar * @return \Illuminate\Database\MySqlConnection * @static */ @@ -5124,7 +5154,7 @@ public static function getPostProcessor() /** * Set the query post processor used by the connection. * - * @param \Illuminate\Database\Query\Processors\Processor $processor + * @param \Illuminate\Database\Query\Processors\Processor $processor * @return \Illuminate\Database\MySqlConnection * @static */ @@ -5149,7 +5179,7 @@ public static function getEventDispatcher() /** * Set the event dispatcher instance on the connection. * - * @param \Illuminate\Contracts\Events\Dispatcher $events + * @param \Illuminate\Contracts\Events\Dispatcher $events * @return \Illuminate\Database\MySqlConnection * @static */ @@ -5258,7 +5288,7 @@ public static function getDatabaseName() /** * Set the name of the connected database. * - * @param string $database + * @param string $database * @return \Illuminate\Database\MySqlConnection * @static */ @@ -5283,7 +5313,7 @@ public static function getTablePrefix() /** * Set the table prefix in use by the connection. * - * @param string $prefix + * @param string $prefix * @return \Illuminate\Database\MySqlConnection * @static */ @@ -5296,7 +5326,7 @@ public static function setTablePrefix($prefix) /** * Set the table prefix and return the grammar. * - * @param \Illuminate\Database\Grammar $grammar + * @param \Illuminate\Database\Grammar $grammar * @return \Illuminate\Database\Grammar * @static */ @@ -5309,8 +5339,8 @@ public static function withTablePrefix($grammar) /** * Register a connection resolver. * - * @param string $driver - * @param \Closure $callback + * @param string $driver + * @param \Closure $callback * @return void * @static */ @@ -5322,7 +5352,7 @@ public static function resolverFor($driver, $callback) /** * Get the connection resolver for the given driver. * - * @param string $driver + * @param string $driver * @return mixed * @static */ @@ -5334,9 +5364,10 @@ public static function getResolver($driver) /** * Execute a Closure within a transaction. * - * @param \Closure $callback - * @param int $attempts + * @param \Closure $callback + * @param int $attempts * @return mixed + * * @throws \Throwable * @static */ @@ -5350,6 +5381,7 @@ public static function transaction($callback, $attempts = 1) * Start a new database transaction. * * @return void + * * @throws \Throwable * @static */ @@ -5363,6 +5395,7 @@ public static function beginTransaction() * Commit the active database transaction. * * @return void + * * @throws \Throwable * @static */ @@ -5375,8 +5408,9 @@ public static function commit() /** * Rollback the active database transaction. * - * @param int|null $toLevel + * @param int|null $toLevel * @return void + * * @throws \Throwable * @static */ @@ -5406,8 +5440,8 @@ class Event /** * Register an event listener with the dispatcher. * - * @param \Closure|string|array $events - * @param \Closure|string|null $listener + * @param \Closure|string|array $events + * @param \Closure|string|null $listener * @return void * @static */ @@ -5420,7 +5454,7 @@ public static function listen($events, $listener = null) /** * Determine if a given event has listeners. * - * @param string $eventName + * @param string $eventName * @return bool * @static */ @@ -5433,7 +5467,7 @@ public static function hasListeners($eventName) /** * Determine if the given event has any wildcard listeners. * - * @param string $eventName + * @param string $eventName * @return bool * @static */ @@ -5446,8 +5480,8 @@ public static function hasWildcardListeners($eventName) /** * Register an event and payload to be fired later. * - * @param string $event - * @param array $payload + * @param string $event + * @param array $payload * @return void * @static */ @@ -5460,7 +5494,7 @@ public static function push($event, $payload = []) /** * Flush a set of pushed events. * - * @param string $event + * @param string $event * @return void * @static */ @@ -5473,7 +5507,7 @@ public static function flush($event) /** * Register an event subscriber with the dispatcher. * - * @param object|string $subscriber + * @param object|string $subscriber * @return void * @static */ @@ -5486,8 +5520,8 @@ public static function subscribe($subscriber) /** * Fire an event until the first non-null response is returned. * - * @param string|object $event - * @param mixed $payload + * @param string|object $event + * @param mixed $payload * @return array|null * @static */ @@ -5500,9 +5534,9 @@ public static function until($event, $payload = []) /** * Fire an event and call the listeners. * - * @param string|object $event - * @param mixed $payload - * @param bool $halt + * @param string|object $event + * @param mixed $payload + * @param bool $halt * @return array|null * @static */ @@ -5515,7 +5549,7 @@ public static function dispatch($event, $payload = [], $halt = false) /** * Get all of the listeners for a given event name. * - * @param string $eventName + * @param string $eventName * @return array * @static */ @@ -5528,8 +5562,8 @@ public static function getListeners($eventName) /** * Register an event listener with the dispatcher. * - * @param \Closure|string $listener - * @param bool $wildcard + * @param \Closure|string $listener + * @param bool $wildcard * @return \Closure * @static */ @@ -5542,8 +5576,8 @@ public static function makeListener($listener, $wildcard = false) /** * Create a class based listener using the IoC container. * - * @param string $listener - * @param bool $wildcard + * @param string $listener + * @param bool $wildcard * @return \Closure * @static */ @@ -5556,7 +5590,7 @@ public static function createClassListener($listener, $wildcard = false) /** * Remove a set of listeners from the dispatcher. * - * @param string $event + * @param string $event * @return void * @static */ @@ -5581,7 +5615,7 @@ public static function forgetPushed() /** * Set the queue resolver implementation. * - * @param callable $resolver + * @param callable $resolver * @return \Illuminate\Events\Dispatcher * @static */ @@ -5594,8 +5628,8 @@ public static function setQueueResolver($resolver) /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -5607,9 +5641,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -5621,7 +5656,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -5633,8 +5668,8 @@ public static function hasMacro($name) /** * Assert if an event was dispatched based on a truth-test callback. * - * @param string|\Closure $event - * @param callable|int|null $callback + * @param string|\Closure $event + * @param callable|int|null $callback * @return void * @static */ @@ -5647,8 +5682,8 @@ public static function assertDispatched($event, $callback = null) /** * Assert if an event was dispatched a number of times. * - * @param string $event - * @param int $times + * @param string $event + * @param int $times * @return void * @static */ @@ -5661,8 +5696,8 @@ public static function assertDispatchedTimes($event, $times = 1) /** * Determine if an event was dispatched based on a truth-test callback. * - * @param string|\Closure $event - * @param callable|null $callback + * @param string|\Closure $event + * @param callable|null $callback * @return void * @static */ @@ -5675,8 +5710,8 @@ public static function assertNotDispatched($event, $callback = null) /** * Get all of the events matching a truth-test callback. * - * @param string $event - * @param callable|null $callback + * @param string $event + * @param callable|null $callback * @return \Illuminate\Support\Collection * @static */ @@ -5689,7 +5724,7 @@ public static function dispatched($event, $callback = null) /** * Determine if the given event has been dispatched. * - * @param string $event + * @param string $event * @return bool * @static */ @@ -5707,7 +5742,7 @@ class File /** * Determine if a file or directory exists. * - * @param string $path + * @param string $path * @return bool * @static */ @@ -5720,7 +5755,7 @@ public static function exists($path) /** * Determine if a file or directory is missing. * - * @param string $path + * @param string $path * @return bool * @static */ @@ -5733,9 +5768,10 @@ public static function missing($path) /** * Get the contents of a file. * - * @param string $path - * @param bool $lock + * @param string $path + * @param bool $lock * @return string + * * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException * @static */ @@ -5748,7 +5784,7 @@ public static function get($path, $lock = false) /** * Get contents of a file with shared access. * - * @param string $path + * @param string $path * @return string * @static */ @@ -5761,9 +5797,10 @@ public static function sharedGet($path) /** * Get the returned value of a file. * - * @param string $path - * @param array $data + * @param string $path + * @param array $data * @return mixed + * * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException * @static */ @@ -5776,8 +5813,8 @@ public static function getRequire($path, $data = []) /** * Require the given file once. * - * @param string $path - * @param array $data + * @param string $path + * @param array $data * @return mixed * @static */ @@ -5790,8 +5827,9 @@ public static function requireOnce($path, $data = []) /** * Get the contents of a file one line at a time. * - * @param string $path + * @param string $path * @return \Illuminate\Support\LazyCollection + * * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException * @static */ @@ -5804,7 +5842,7 @@ public static function lines($path) /** * Get the MD5 hash of the file at the given path. * - * @param string $path + * @param string $path * @return string * @static */ @@ -5817,9 +5855,9 @@ public static function hash($path) /** * Write the contents of a file. * - * @param string $path - * @param string $contents - * @param bool $lock + * @param string $path + * @param string $contents + * @param bool $lock * @return int|bool * @static */ @@ -5832,8 +5870,8 @@ public static function put($path, $contents, $lock = false) /** * Write the contents of a file, replacing it atomically if it already exists. * - * @param string $path - * @param string $content + * @param string $path + * @param string $content * @return void * @static */ @@ -5846,8 +5884,8 @@ public static function replace($path, $content) /** * Prepend to a file. * - * @param string $path - * @param string $data + * @param string $path + * @param string $data * @return int * @static */ @@ -5860,8 +5898,8 @@ public static function prepend($path, $data) /** * Append to a file. * - * @param string $path - * @param string $data + * @param string $path + * @param string $data * @return int * @static */ @@ -5874,8 +5912,8 @@ public static function append($path, $data) /** * Get or set UNIX mode of a file or directory. * - * @param string $path - * @param int|null $mode + * @param string $path + * @param int|null $mode * @return mixed * @static */ @@ -5888,7 +5926,7 @@ public static function chmod($path, $mode = null) /** * Delete the file at a given path. * - * @param string|array $paths + * @param string|array $paths * @return bool * @static */ @@ -5901,8 +5939,8 @@ public static function delete($paths) /** * Move a file to a new location. * - * @param string $path - * @param string $target + * @param string $path + * @param string $target * @return bool * @static */ @@ -5915,8 +5953,8 @@ public static function move($path, $target) /** * Copy a file to a new location. * - * @param string $path - * @param string $target + * @param string $path + * @param string $target * @return bool * @static */ @@ -5929,8 +5967,8 @@ public static function copy($path, $target) /** * Create a symlink to the target file or directory. On Windows, a hard link is created if the target is a file. * - * @param string $target - * @param string $link + * @param string $target + * @param string $link * @return void * @static */ @@ -5943,8 +5981,8 @@ public static function link($target, $link) /** * Create a relative symlink to the target file or directory. * - * @param string $target - * @param string $link + * @param string $target + * @param string $link * @return void * @static */ @@ -5957,7 +5995,7 @@ public static function relativeLink($target, $link) /** * Extract the file name from a file path. * - * @param string $path + * @param string $path * @return string * @static */ @@ -5970,7 +6008,7 @@ public static function name($path) /** * Extract the trailing name component from a file path. * - * @param string $path + * @param string $path * @return string * @static */ @@ -5983,7 +6021,7 @@ public static function basename($path) /** * Extract the parent directory from a file path. * - * @param string $path + * @param string $path * @return string * @static */ @@ -5996,7 +6034,7 @@ public static function dirname($path) /** * Extract the file extension from a file path. * - * @param string $path + * @param string $path * @return string * @static */ @@ -6009,7 +6047,7 @@ public static function extension($path) /** * Guess the file extension from the mime-type of a given file. * - * @param string $path + * @param string $path * @return string|null * @static */ @@ -6022,7 +6060,7 @@ public static function guessExtension($path) /** * Get the file type of a given file. * - * @param string $path + * @param string $path * @return string * @static */ @@ -6035,7 +6073,7 @@ public static function type($path) /** * Get the mime-type of a given file. * - * @param string $path + * @param string $path * @return string|false * @static */ @@ -6048,7 +6086,7 @@ public static function mimeType($path) /** * Get the file size of a given file. * - * @param string $path + * @param string $path * @return int * @static */ @@ -6061,7 +6099,7 @@ public static function size($path) /** * Get the file's last modification time. * - * @param string $path + * @param string $path * @return int * @static */ @@ -6074,7 +6112,7 @@ public static function lastModified($path) /** * Determine if the given path is a directory. * - * @param string $directory + * @param string $directory * @return bool * @static */ @@ -6087,7 +6125,7 @@ public static function isDirectory($directory) /** * Determine if the given path is readable. * - * @param string $path + * @param string $path * @return bool * @static */ @@ -6100,7 +6138,7 @@ public static function isReadable($path) /** * Determine if the given path is writable. * - * @param string $path + * @param string $path * @return bool * @static */ @@ -6113,7 +6151,7 @@ public static function isWritable($path) /** * Determine if the given path is a file. * - * @param string $file + * @param string $file * @return bool * @static */ @@ -6126,8 +6164,8 @@ public static function isFile($file) /** * Find path names matching a given pattern. * - * @param string $pattern - * @param int $flags + * @param string $pattern + * @param int $flags * @return array * @static */ @@ -6140,8 +6178,8 @@ public static function glob($pattern, $flags = 0) /** * Get an array of all files in a directory. * - * @param string $directory - * @param bool $hidden + * @param string $directory + * @param bool $hidden * @return \Symfony\Component\Finder\SplFileInfo[] * @static */ @@ -6154,8 +6192,8 @@ public static function files($directory, $hidden = false) /** * Get all of the files from the given directory (recursive). * - * @param string $directory - * @param bool $hidden + * @param string $directory + * @param bool $hidden * @return \Symfony\Component\Finder\SplFileInfo[] * @static */ @@ -6168,7 +6206,7 @@ public static function allFiles($directory, $hidden = false) /** * Get all of the directories within a given directory. * - * @param string $directory + * @param string $directory * @return array * @static */ @@ -6181,9 +6219,9 @@ public static function directories($directory) /** * Ensure a directory exists. * - * @param string $path - * @param int $mode - * @param bool $recursive + * @param string $path + * @param int $mode + * @param bool $recursive * @return void * @static */ @@ -6196,10 +6234,10 @@ public static function ensureDirectoryExists($path, $mode = 493, $recursive = tr /** * Create a directory. * - * @param string $path - * @param int $mode - * @param bool $recursive - * @param bool $force + * @param string $path + * @param int $mode + * @param bool $recursive + * @param bool $force * @return bool * @static */ @@ -6212,9 +6250,9 @@ public static function makeDirectory($path, $mode = 493, $recursive = false, $fo /** * Move a directory. * - * @param string $from - * @param string $to - * @param bool $overwrite + * @param string $from + * @param string $to + * @param bool $overwrite * @return bool * @static */ @@ -6227,9 +6265,9 @@ public static function moveDirectory($from, $to, $overwrite = false) /** * Copy a directory from one location to another. * - * @param string $directory - * @param string $destination - * @param int|null $options + * @param string $directory + * @param string $destination + * @param int|null $options * @return bool * @static */ @@ -6244,8 +6282,8 @@ public static function copyDirectory($directory, $destination, $options = null) * * The directory itself may be optionally preserved. * - * @param string $directory - * @param bool $preserve + * @param string $directory + * @param bool $preserve * @return bool * @static */ @@ -6258,7 +6296,7 @@ public static function deleteDirectory($directory, $preserve = false) /** * Remove all of the directories within a given directory. * - * @param string $directory + * @param string $directory * @return bool * @static */ @@ -6271,7 +6309,7 @@ public static function deleteDirectories($directory) /** * Empty the specified directory of all files and folders. * - * @param string $directory + * @param string $directory * @return bool * @static */ @@ -6284,8 +6322,8 @@ public static function cleanDirectory($directory) /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -6297,9 +6335,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -6311,7 +6350,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -6328,7 +6367,7 @@ class Gate /** * Determine if a given ability has been defined. * - * @param string|array $ability + * @param string|array $ability * @return bool * @static */ @@ -6341,9 +6380,10 @@ public static function has($ability) /** * Define a new ability. * - * @param string $ability - * @param callable|string $callback + * @param string $ability + * @param callable|string $callback * @return \Illuminate\Auth\Access\Gate + * * @throws \InvalidArgumentException * @static */ @@ -6356,9 +6396,9 @@ public static function define($ability, $callback) /** * Define abilities for a resource. * - * @param string $name - * @param string $class - * @param array|null $abilities + * @param string $name + * @param string $class + * @param array|null $abilities * @return \Illuminate\Auth\Access\Gate * @static */ @@ -6371,8 +6411,8 @@ public static function resource($name, $class, $abilities = null) /** * Define a policy class for a given class type. * - * @param string $class - * @param string $policy + * @param string $class + * @param string $policy * @return \Illuminate\Auth\Access\Gate * @static */ @@ -6385,7 +6425,7 @@ public static function policy($class, $policy) /** * Register a callback to run before all Gate checks. * - * @param callable $callback + * @param callable $callback * @return \Illuminate\Auth\Access\Gate * @static */ @@ -6398,7 +6438,7 @@ public static function before($callback) /** * Register a callback to run after all Gate checks. * - * @param callable $callback + * @param callable $callback * @return \Illuminate\Auth\Access\Gate * @static */ @@ -6411,8 +6451,8 @@ public static function after($callback) /** * Determine if the given ability should be granted for the current user. * - * @param string $ability - * @param array|mixed $arguments + * @param string $ability + * @param array|mixed $arguments * @return bool * @static */ @@ -6425,8 +6465,8 @@ public static function allows($ability, $arguments = []) /** * Determine if the given ability should be denied for the current user. * - * @param string $ability - * @param array|mixed $arguments + * @param string $ability + * @param array|mixed $arguments * @return bool * @static */ @@ -6439,8 +6479,8 @@ public static function denies($ability, $arguments = []) /** * Determine if all of the given abilities should be granted for the current user. * - * @param \Illuminate\Auth\Access\iterable|string $abilities - * @param array|mixed $arguments + * @param \Illuminate\Auth\Access\iterable|string $abilities + * @param array|mixed $arguments * @return bool * @static */ @@ -6453,8 +6493,8 @@ public static function check($abilities, $arguments = []) /** * Determine if any one of the given abilities should be granted for the current user. * - * @param \Illuminate\Auth\Access\iterable|string $abilities - * @param array|mixed $arguments + * @param \Illuminate\Auth\Access\iterable|string $abilities + * @param array|mixed $arguments * @return bool * @static */ @@ -6467,8 +6507,8 @@ public static function any($abilities, $arguments = []) /** * Determine if all of the given abilities should be denied for the current user. * - * @param \Illuminate\Auth\Access\iterable|string $abilities - * @param array|mixed $arguments + * @param \Illuminate\Auth\Access\iterable|string $abilities + * @param array|mixed $arguments * @return bool * @static */ @@ -6481,9 +6521,10 @@ public static function none($abilities, $arguments = []) /** * Determine if the given ability should be granted for the current user. * - * @param string $ability - * @param array|mixed $arguments + * @param string $ability + * @param array|mixed $arguments * @return \Illuminate\Auth\Access\Response + * * @throws \Illuminate\Auth\Access\AuthorizationException * @static */ @@ -6496,8 +6537,8 @@ public static function authorize($ability, $arguments = []) /** * Inspect the user for the given ability. * - * @param string $ability - * @param array|mixed $arguments + * @param string $ability + * @param array|mixed $arguments * @return \Illuminate\Auth\Access\Response * @static */ @@ -6510,9 +6551,10 @@ public static function inspect($ability, $arguments = []) /** * Get the raw result from the authorization callback. * - * @param string $ability - * @param array|mixed $arguments + * @param string $ability + * @param array|mixed $arguments * @return mixed + * * @throws \Illuminate\Auth\Access\AuthorizationException * @static */ @@ -6525,7 +6567,7 @@ public static function raw($ability, $arguments = []) /** * Get a policy instance for a given class. * - * @param object|string $class + * @param object|string $class * @return mixed * @static */ @@ -6538,7 +6580,7 @@ public static function getPolicyFor($class) /** * Specify a callback to be used to guess policy names. * - * @param callable $callback + * @param callable $callback * @return \Illuminate\Auth\Access\Gate * @static */ @@ -6551,8 +6593,9 @@ public static function guessPolicyNamesUsing($callback) /** * Build a policy class instance of the given type. * - * @param object|string $class + * @param object|string $class * @return mixed + * * @throws \Illuminate\Contracts\Container\BindingResolutionException * @static */ @@ -6565,7 +6608,7 @@ public static function resolvePolicy($class) /** * Get a gate instance for the given user. * - * @param \Illuminate\Contracts\Auth\Authenticatable|mixed $user + * @param \Illuminate\Contracts\Auth\Authenticatable|mixed $user * @return static * @static */ @@ -6643,7 +6686,7 @@ public static function createArgon2idDriver() /** * Get information about the given hashed value. * - * @param string $hashedValue + * @param string $hashedValue * @return array * @static */ @@ -6656,8 +6699,8 @@ public static function info($hashedValue) /** * Hash the given value. * - * @param string $value - * @param array $options + * @param string $value + * @param array $options * @return string * @static */ @@ -6670,9 +6713,9 @@ public static function make($value, $options = []) /** * Check the given plain value against a hash. * - * @param string $value - * @param string $hashedValue - * @param array $options + * @param string $value + * @param string $hashedValue + * @param array $options * @return bool * @static */ @@ -6685,8 +6728,8 @@ public static function check($value, $hashedValue, $options = []) /** * Check if the given hash has been hashed using the given options. * - * @param string $hashedValue - * @param array $options + * @param string $hashedValue + * @param array $options * @return bool * @static */ @@ -6711,8 +6754,9 @@ public static function getDefaultDriver() /** * Get a driver instance. * - * @param string|null $driver + * @param string|null $driver * @return mixed + * * @throws \InvalidArgumentException * @static */ @@ -6725,8 +6769,8 @@ public static function driver($driver = null) /** * Register a custom driver creator Closure. * - * @param string $driver - * @param \Closure $callback + * @param string $driver + * @param \Closure $callback * @return \Illuminate\Hashing\HashManager * @static */ @@ -6778,6 +6822,7 @@ public static function getDrivers() * @method static \Illuminate\Http\Client\Response post(string $url, array $data = []) * @method static \Illuminate\Http\Client\Response put(string $url, array $data = []) * @method static \Illuminate\Http\Client\Response send(string $method, string $url, array $options = []) + * * @see \Illuminate\Http\Client\Factory */ class Http @@ -6785,9 +6830,9 @@ class Http /** * Create a new response instance for use during stubbing. * - * @param array|string $body - * @param int $status - * @param array $headers + * @param array|string $body + * @param int $status + * @param array $headers * @return \GuzzleHttp\Promise\PromiseInterface * @static */ @@ -6799,7 +6844,7 @@ public static function response($body = null, $status = 200, $headers = []) /** * Get an invokable object that returns a sequence of responses in order for use during stubbing. * - * @param array $responses + * @param array $responses * @return \Illuminate\Http\Client\ResponseSequence * @static */ @@ -6812,7 +6857,7 @@ public static function sequence($responses = []) /** * Register a stub callable that will intercept requests and be able to return stub responses. * - * @param callable|array $callback + * @param callable|array $callback * @return \Illuminate\Http\Client\Factory * @static */ @@ -6825,7 +6870,7 @@ public static function fake($callback = null) /** * Register a response sequence for the given URL pattern. * - * @param string $url + * @param string $url * @return \Illuminate\Http\Client\ResponseSequence * @static */ @@ -6838,8 +6883,8 @@ public static function fakeSequence($url = '*') /** * Stub the given URL using the given callback. * - * @param string $url - * @param \Illuminate\Http\Client\Response|\GuzzleHttp\Promise\PromiseInterface|callable $callback + * @param string $url + * @param \Illuminate\Http\Client\Response|\GuzzleHttp\Promise\PromiseInterface|callable $callback * @return \Illuminate\Http\Client\Factory * @static */ @@ -6852,8 +6897,8 @@ public static function stubUrl($url, $callback) /** * Record a request response pair. * - * @param \Illuminate\Http\Client\Request $request - * @param \Illuminate\Http\Client\Response $response + * @param \Illuminate\Http\Client\Request $request + * @param \Illuminate\Http\Client\Response $response * @return void * @static */ @@ -6866,7 +6911,7 @@ public static function recordRequestResponsePair($request, $response) /** * Assert that a request / response pair was recorded matching a given truth test. * - * @param callable $callback + * @param callable $callback * @return void * @static */ @@ -6879,7 +6924,7 @@ public static function assertSent($callback) /** * Assert that a request / response pair was not recorded matching a given truth test. * - * @param callable $callback + * @param callable $callback * @return void * @static */ @@ -6904,7 +6949,7 @@ public static function assertNothingSent() /** * Assert how many requests have been recorded. * - * @param int $count + * @param int $count * @return void * @static */ @@ -6929,7 +6974,7 @@ public static function assertSequencesAreEmpty() /** * Get a collection of the request / response pairs matching the given truth test. * - * @param callable $callback + * @param callable $callback * @return \Illuminate\Support\Collection * @static */ @@ -6942,8 +6987,8 @@ public static function recorded($callback = null) /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -6955,9 +7000,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -6969,7 +7015,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -6981,9 +7027,10 @@ public static function hasMacro($name) /** * Dynamically handle calls to the class. * - * @param string $method - * @param array $parameters + * @param string $method + * @param array $parameters * @return mixed + * * @throws \BadMethodCallException * @static */ @@ -7001,8 +7048,8 @@ class Lang /** * Determine if a translation exists for a given locale. * - * @param string $key - * @param string|null $locale + * @param string $key + * @param string|null $locale * @return bool * @static */ @@ -7015,9 +7062,9 @@ public static function hasForLocale($key, $locale = null) /** * Determine if a translation exists. * - * @param string $key - * @param string|null $locale - * @param bool $fallback + * @param string $key + * @param string|null $locale + * @param bool $fallback * @return bool * @static */ @@ -7030,10 +7077,10 @@ public static function has($key, $locale = null, $fallback = true) /** * Get the translation for the given key. * - * @param string $key - * @param array $replace - * @param string|null $locale - * @param bool $fallback + * @param string $key + * @param array $replace + * @param string|null $locale + * @param bool $fallback * @return string|array * @static */ @@ -7046,10 +7093,10 @@ public static function get($key, $replace = [], $locale = null, $fallback = true /** * Get a translation according to an integer value. * - * @param string $key - * @param \Countable|int|array $number - * @param array $replace - * @param string|null $locale + * @param string $key + * @param \Countable|int|array $number + * @param array $replace + * @param string|null $locale * @return string * @static */ @@ -7062,9 +7109,9 @@ public static function choice($key, $number, $replace = [], $locale = null) /** * Add translation lines to the given locale. * - * @param array $lines - * @param string $locale - * @param string $namespace + * @param array $lines + * @param string $locale + * @param string $namespace * @return void * @static */ @@ -7077,9 +7124,9 @@ public static function addLines($lines, $locale, $namespace = '*') /** * Load the specified language group. * - * @param string $namespace - * @param string $group - * @param string $locale + * @param string $namespace + * @param string $group + * @param string $locale * @return void * @static */ @@ -7092,8 +7139,8 @@ public static function load($namespace, $group, $locale) /** * Add a new namespace to the loader. * - * @param string $namespace - * @param string $hint + * @param string $namespace + * @param string $hint * @return void * @static */ @@ -7106,7 +7153,7 @@ public static function addNamespace($namespace, $hint) /** * Add a new JSON path to the loader. * - * @param string $path + * @param string $path * @return void * @static */ @@ -7119,7 +7166,7 @@ public static function addJsonPath($path) /** * Parse a key into namespace, group, and item. * - * @param string $key + * @param string $key * @return array * @static */ @@ -7144,7 +7191,7 @@ public static function getSelector() /** * Set the message selector instance. * - * @param \Illuminate\Translation\MessageSelector $selector + * @param \Illuminate\Translation\MessageSelector $selector * @return void * @static */ @@ -7193,7 +7240,7 @@ public static function getLocale() /** * Set the default locale. * - * @param string $locale + * @param string $locale * @return void * @static */ @@ -7218,7 +7265,7 @@ public static function getFallback() /** * Set the fallback locale being used. * - * @param string $fallback + * @param string $fallback * @return void * @static */ @@ -7231,7 +7278,7 @@ public static function setFallback($fallback) /** * Set the loaded translation groups. * - * @param array $loaded + * @param array $loaded * @return void * @static */ @@ -7244,8 +7291,8 @@ public static function setLoaded($loaded) /** * Set the parsed value of a key. * - * @param string $key - * @param array $parsed + * @param string $key + * @param array $parsed * @return void * @static */ @@ -7258,8 +7305,8 @@ public static function setParsedKey($key, $parsed) /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -7271,9 +7318,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -7285,7 +7333,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -7297,6 +7345,7 @@ public static function hasMacro($name) /** * @method static void write(string $level, string $message, array $context = []) * @method static void listen(\Closure $callback) + * * @see \Illuminate\Log\Logger */ class Log @@ -7304,8 +7353,8 @@ class Log /** * Create a new, on-demand aggregate logger instance. * - * @param array $channels - * @param string|null $channel + * @param array $channels + * @param string|null $channel * @return \Psr\Log\LoggerInterface * @static */ @@ -7318,7 +7367,7 @@ public static function stack($channels, $channel = null) /** * Get a log channel instance. * - * @param string|null $channel + * @param string|null $channel * @return \Psr\Log\LoggerInterface * @static */ @@ -7331,7 +7380,7 @@ public static function channel($channel = null) /** * Get a log driver instance. * - * @param string|null $driver + * @param string|null $driver * @return \Psr\Log\LoggerInterface * @static */ @@ -7366,7 +7415,7 @@ public static function getDefaultDriver() /** * Set the default log driver name. * - * @param string $name + * @param string $name * @return void * @static */ @@ -7379,8 +7428,8 @@ public static function setDefaultDriver($name) /** * Register a custom driver creator Closure. * - * @param string $driver - * @param \Closure $callback + * @param string $driver + * @param \Closure $callback * @return \Illuminate\Log\LogManager * @static */ @@ -7393,7 +7442,7 @@ public static function extend($driver, $callback) /** * Unset the given channel instance. * - * @param string|null $driver + * @param string|null $driver * @return \Illuminate\Log\LogManager * @static */ @@ -7406,8 +7455,8 @@ public static function forgetChannel($driver = null) /** * System is unusable. * - * @param string $message - * @param array $context + * @param string $message + * @param array $context * @return void * @static */ @@ -7423,8 +7472,8 @@ public static function emergency($message, $context = []) * Example: Entire website down, database unavailable, etc. This should * trigger the SMS alerts and wake you up. * - * @param string $message - * @param array $context + * @param string $message + * @param array $context * @return void * @static */ @@ -7439,8 +7488,8 @@ public static function alert($message, $context = []) * * Example: Application component unavailable, unexpected exception. * - * @param string $message - * @param array $context + * @param string $message + * @param array $context * @return void * @static */ @@ -7454,8 +7503,8 @@ public static function critical($message, $context = []) * Runtime errors that do not require immediate action but should typically * be logged and monitored. * - * @param string $message - * @param array $context + * @param string $message + * @param array $context * @return void * @static */ @@ -7471,8 +7520,8 @@ public static function error($message, $context = []) * Example: Use of deprecated APIs, poor use of an API, undesirable things * that are not necessarily wrong. * - * @param string $message - * @param array $context + * @param string $message + * @param array $context * @return void * @static */ @@ -7485,8 +7534,8 @@ public static function warning($message, $context = []) /** * Normal but significant events. * - * @param string $message - * @param array $context + * @param string $message + * @param array $context * @return void * @static */ @@ -7501,8 +7550,8 @@ public static function notice($message, $context = []) * * Example: User logs in, SQL logs. * - * @param string $message - * @param array $context + * @param string $message + * @param array $context * @return void * @static */ @@ -7515,8 +7564,8 @@ public static function info($message, $context = []) /** * Detailed debug information. * - * @param string $message - * @param array $context + * @param string $message + * @param array $context * @return void * @static */ @@ -7529,9 +7578,9 @@ public static function debug($message, $context = []) /** * Logs with an arbitrary level. * - * @param mixed $level - * @param string $message - * @param array $context + * @param mixed $level + * @param string $message + * @param array $context * @return void * @static */ @@ -7546,6 +7595,7 @@ public static function log($level, $message, $context = []) * @method static mixed queueOn(string $queue, \Illuminate\Contracts\Mail\Mailable|string|array $view) * @method static void plain(string $view, array $data, $callback) * @method static void html(string $html, $callback) + * * @see \Illuminate\Mail\Mailer * @see \Illuminate\Support\Testing\Fakes\MailFake */ @@ -7554,7 +7604,7 @@ class Mail /** * Get a mailer instance by name. * - * @param string|null $name + * @param string|null $name * @return \Illuminate\Mail\Mailer * @static */ @@ -7567,7 +7617,7 @@ public static function mailer($name = null) /** * Get a mailer driver instance. * - * @param string|null $driver + * @param string|null $driver * @return \Illuminate\Mail\Mailer * @static */ @@ -7580,7 +7630,7 @@ public static function driver($driver = null) /** * Create a new transport instance. * - * @param array $config + * @param array $config * @return \Swift_Transport * @static */ @@ -7605,7 +7655,7 @@ public static function getDefaultDriver() /** * Set the default mail driver name. * - * @param string $name + * @param string $name * @return void * @static */ @@ -7618,7 +7668,7 @@ public static function setDefaultDriver($name) /** * Disconnect the given mailer and remove from local cache. * - * @param string|null $name + * @param string|null $name * @return void * @static */ @@ -7631,8 +7681,8 @@ public static function purge($name = null) /** * Register a custom transport creator Closure. * - * @param string $driver - * @param \Closure $callback + * @param string $driver + * @param \Closure $callback * @return \Illuminate\Mail\MailManager * @static */ @@ -7645,8 +7695,8 @@ public static function extend($driver, $callback) /** * Assert if a mailable was sent based on a truth-test callback. * - * @param string|\Closure $mailable - * @param callable|int|null $callback + * @param string|\Closure $mailable + * @param callable|int|null $callback * @return void * @static */ @@ -7659,8 +7709,8 @@ public static function assertSent($mailable, $callback = null) /** * Determine if a mailable was not sent based on a truth-test callback. * - * @param string $mailable - * @param callable|null $callback + * @param string $mailable + * @param callable|null $callback * @return void * @static */ @@ -7685,8 +7735,8 @@ public static function assertNothingSent() /** * Assert if a mailable was queued based on a truth-test callback. * - * @param string|\Closure $mailable - * @param callable|int|null $callback + * @param string|\Closure $mailable + * @param callable|int|null $callback * @return void * @static */ @@ -7699,8 +7749,8 @@ public static function assertQueued($mailable, $callback = null) /** * Determine if a mailable was not queued based on a truth-test callback. * - * @param string $mailable - * @param callable|null $callback + * @param string $mailable + * @param callable|null $callback * @return void * @static */ @@ -7725,8 +7775,8 @@ public static function assertNothingQueued() /** * Get all of the mailables matching a truth-test callback. * - * @param string $mailable - * @param callable|null $callback + * @param string $mailable + * @param callable|null $callback * @return \Illuminate\Support\Collection * @static */ @@ -7739,7 +7789,7 @@ public static function sent($mailable, $callback = null) /** * Determine if the given mailable has been sent. * - * @param string $mailable + * @param string $mailable * @return bool * @static */ @@ -7752,8 +7802,8 @@ public static function hasSent($mailable) /** * Get all of the queued mailables matching a truth-test callback. * - * @param string $mailable - * @param callable|null $callback + * @param string $mailable + * @param callable|null $callback * @return \Illuminate\Support\Collection * @static */ @@ -7766,7 +7816,7 @@ public static function queued($mailable, $callback = null) /** * Determine if the given mailable has been queued. * - * @param string $mailable + * @param string $mailable * @return bool * @static */ @@ -7779,7 +7829,7 @@ public static function hasQueued($mailable) /** * Begin the process of mailing a mailable class instance. * - * @param mixed $users + * @param mixed $users * @return \Illuminate\Mail\PendingMail * @static */ @@ -7792,7 +7842,7 @@ public static function to($users) /** * Begin the process of mailing a mailable class instance. * - * @param mixed $users + * @param mixed $users * @return \Illuminate\Mail\PendingMail * @static */ @@ -7805,8 +7855,8 @@ public static function bcc($users) /** * Send a new message with only a raw text part. * - * @param string $text - * @param \Closure|string $callback + * @param string $text + * @param \Closure|string $callback * @return void * @static */ @@ -7819,9 +7869,9 @@ public static function raw($text, $callback) /** * Send a new message using a view. * - * @param string|array $view - * @param array $data - * @param \Closure|string|null $callback + * @param string|array $view + * @param array $data + * @param \Closure|string|null $callback * @return void * @static */ @@ -7834,8 +7884,8 @@ public static function send($view, $data = [], $callback = null) /** * Queue a new e-mail message for sending. * - * @param string|array $view - * @param string|null $queue + * @param string|array $view + * @param string|null $queue * @return mixed * @static */ @@ -7848,9 +7898,9 @@ public static function queue($view, $queue = null) /** * Queue a new e-mail message for sending after (n) seconds. * - * @param \DateTimeInterface|\DateInterval|int $delay - * @param \Illuminate\Contracts\Mail\Mailable|string|array $view - * @param string|null $queue + * @param \DateTimeInterface|\DateInterval|int $delay + * @param \Illuminate\Contracts\Mail\Mailable|string|array $view + * @param string|null $queue * @return mixed * @static */ @@ -7880,8 +7930,8 @@ class Notification /** * Send the given notification to the given notifiable entities. * - * @param \Illuminate\Support\Collection|array|mixed $notifiables - * @param mixed $notification + * @param \Illuminate\Support\Collection|array|mixed $notifiables + * @param mixed $notification * @return void * @static */ @@ -7894,9 +7944,9 @@ public static function send($notifiables, $notification) /** * Send the given notification immediately. * - * @param \Illuminate\Support\Collection|array|mixed $notifiables - * @param mixed $notification - * @param array|null $channels + * @param \Illuminate\Support\Collection|array|mixed $notifiables + * @param mixed $notification + * @param array|null $channels * @return void * @static */ @@ -7909,7 +7959,7 @@ public static function sendNow($notifiables, $notification, $channels = null) /** * Get a channel instance. * - * @param string|null $name + * @param string|null $name * @return mixed * @static */ @@ -7946,7 +7996,7 @@ public static function deliversVia() /** * Set the default channel driver name. * - * @param string $channel + * @param string $channel * @return void * @static */ @@ -7959,7 +8009,7 @@ public static function deliverVia($channel) /** * Set the locale of notifications. * - * @param string $locale + * @param string $locale * @return \Illuminate\Notifications\ChannelManager * @static */ @@ -7972,8 +8022,9 @@ public static function locale($locale) /** * Get a driver instance. * - * @param string|null $driver + * @param string|null $driver * @return mixed + * * @throws \InvalidArgumentException * @static */ @@ -7986,8 +8037,8 @@ public static function driver($driver = null) /** * Register a custom driver creator Closure. * - * @param string $driver - * @param \Closure $callback + * @param string $driver + * @param \Closure $callback * @return \Illuminate\Notifications\ChannelManager * @static */ @@ -8012,10 +8063,11 @@ public static function getDrivers() /** * Assert if a notification was sent based on a truth-test callback. * - * @param mixed $notifiable - * @param string|\Closure $notification - * @param callable|null $callback + * @param mixed $notifiable + * @param string|\Closure $notification + * @param callable|null $callback * @return void + * * @throws \Exception * @static */ @@ -8028,9 +8080,9 @@ public static function assertSentTo($notifiable, $notification, $callback = null /** * Assert if a notification was sent a number of times. * - * @param mixed $notifiable - * @param string $notification - * @param int $times + * @param mixed $notifiable + * @param string $notification + * @param int $times * @return void * @static */ @@ -8043,10 +8095,11 @@ public static function assertSentToTimes($notifiable, $notification, $times = 1) /** * Determine if a notification was sent based on a truth-test callback. * - * @param mixed $notifiable - * @param string|\Closure $notification - * @param callable|null $callback + * @param mixed $notifiable + * @param string|\Closure $notification + * @param callable|null $callback * @return void + * * @throws \Exception * @static */ @@ -8071,8 +8124,8 @@ public static function assertNothingSent() /** * Assert the total amount of times a notification was sent. * - * @param int $expectedCount - * @param string $notification + * @param int $expectedCount + * @param string $notification * @return void * @static */ @@ -8085,9 +8138,9 @@ public static function assertTimesSent($expectedCount, $notification) /** * Get all of the notifications matching a truth-test callback. * - * @param mixed $notifiable - * @param string $notification - * @param callable|null $callback + * @param mixed $notifiable + * @param string $notification + * @param callable|null $callback * @return \Illuminate\Support\Collection * @static */ @@ -8100,8 +8153,8 @@ public static function sent($notifiable, $notification, $callback = null) /** * Determine if there are more notifications left to inspect. * - * @param mixed $notifiable - * @param string $notification + * @param mixed $notifiable + * @param string $notification * @return bool * @static */ @@ -8114,8 +8167,8 @@ public static function hasSent($notifiable, $notification) /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -8127,9 +8180,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -8141,7 +8195,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -8158,6 +8212,7 @@ public static function hasMacro($name) * @method static void deleteToken(\Illuminate\Contracts\Auth\CanResetPassword $user) * @method static bool tokenExists(\Illuminate\Contracts\Auth\CanResetPassword $user, string $token) * @method static \Illuminate\Auth\Passwords\TokenRepositoryInterface getRepository() + * * @see \Illuminate\Auth\Passwords\PasswordBroker */ class Password @@ -8165,7 +8220,7 @@ class Password /** * Attempt to get the broker from the local cache. * - * @param string|null $name + * @param string|null $name * @return \Illuminate\Contracts\Auth\PasswordBroker * @static */ @@ -8190,7 +8245,7 @@ public static function getDefaultDriver() /** * Set the default password broker name. * - * @param string $name + * @param string $name * @return void * @static */ @@ -8202,6 +8257,7 @@ public static function setDefaultDriver($name) } /** * @method static void popUsing(string $workerName, callable $callback) + * * @see \Illuminate\Queue\QueueManager * @see \Illuminate\Queue\Queue */ @@ -8210,7 +8266,7 @@ class Queue /** * Register an event listener for the before job event. * - * @param mixed $callback + * @param mixed $callback * @return void * @static */ @@ -8223,7 +8279,7 @@ public static function before($callback) /** * Register an event listener for the after job event. * - * @param mixed $callback + * @param mixed $callback * @return void * @static */ @@ -8236,7 +8292,7 @@ public static function after($callback) /** * Register an event listener for the exception occurred job event. * - * @param mixed $callback + * @param mixed $callback * @return void * @static */ @@ -8249,7 +8305,7 @@ public static function exceptionOccurred($callback) /** * Register an event listener for the daemon queue loop. * - * @param mixed $callback + * @param mixed $callback * @return void * @static */ @@ -8262,7 +8318,7 @@ public static function looping($callback) /** * Register an event listener for the failed job event. * - * @param mixed $callback + * @param mixed $callback * @return void * @static */ @@ -8275,7 +8331,7 @@ public static function failing($callback) /** * Register an event listener for the daemon queue stopping. * - * @param mixed $callback + * @param mixed $callback * @return void * @static */ @@ -8288,7 +8344,7 @@ public static function stopping($callback) /** * Determine if the driver is connected. * - * @param string|null $name + * @param string|null $name * @return bool * @static */ @@ -8301,7 +8357,7 @@ public static function connected($name = null) /** * Resolve a queue connection instance. * - * @param string|null $name + * @param string|null $name * @return \Illuminate\Contracts\Queue\Queue * @static */ @@ -8314,8 +8370,8 @@ public static function connection($name = null) /** * Add a queue connection resolver. * - * @param string $driver - * @param \Closure $resolver + * @param string $driver + * @param \Closure $resolver * @return void * @static */ @@ -8328,8 +8384,8 @@ public static function extend($driver, $resolver) /** * Add a queue connection resolver. * - * @param string $driver - * @param \Closure $resolver + * @param string $driver + * @param \Closure $resolver * @return void * @static */ @@ -8354,7 +8410,7 @@ public static function getDefaultDriver() /** * Set the name of the default queue connection. * - * @param string $name + * @param string $name * @return void * @static */ @@ -8367,7 +8423,7 @@ public static function setDefaultDriver($name) /** * Get the full name for the given connection. * - * @param string|null $connection + * @param string|null $connection * @return string * @static */ @@ -8380,8 +8436,8 @@ public static function getName($connection = null) /** * Assert if a job was pushed based on a truth-test callback. * - * @param string|\Closure $job - * @param callable|int|null $callback + * @param string|\Closure $job + * @param callable|int|null $callback * @return void * @static */ @@ -8394,9 +8450,9 @@ public static function assertPushed($job, $callback = null) /** * Assert if a job was pushed based on a truth-test callback. * - * @param string $queue - * @param string|\Closure $job - * @param callable|null $callback + * @param string $queue + * @param string|\Closure $job + * @param callable|null $callback * @return void * @static */ @@ -8409,9 +8465,9 @@ public static function assertPushedOn($queue, $job, $callback = null) /** * Assert if a job was pushed with chained jobs based on a truth-test callback. * - * @param string $job - * @param array $expectedChain - * @param callable|null $callback + * @param string $job + * @param array $expectedChain + * @param callable|null $callback * @return void * @static */ @@ -8424,8 +8480,8 @@ public static function assertPushedWithChain($job, $expectedChain = [], $callbac /** * Assert if a job was pushed with an empty chain based on a truth-test callback. * - * @param string $job - * @param callable|null $callback + * @param string $job + * @param callable|null $callback * @return void * @static */ @@ -8438,8 +8494,8 @@ public static function assertPushedWithoutChain($job, $callback = null) /** * Determine if a job was pushed based on a truth-test callback. * - * @param string|\Closure $job - * @param callable|null $callback + * @param string|\Closure $job + * @param callable|null $callback * @return void * @static */ @@ -8464,8 +8520,8 @@ public static function assertNothingPushed() /** * Get all of the jobs matching a truth-test callback. * - * @param string $job - * @param callable|null $callback + * @param string $job + * @param callable|null $callback * @return \Illuminate\Support\Collection * @static */ @@ -8478,7 +8534,7 @@ public static function pushed($job, $callback = null) /** * Determine if there are any stored jobs for a given class. * - * @param string $job + * @param string $job * @return bool * @static */ @@ -8491,7 +8547,7 @@ public static function hasPushed($job) /** * Get the size of the queue. * - * @param string|null $queue + * @param string|null $queue * @return int * @static */ @@ -8504,9 +8560,9 @@ public static function size($queue = null) /** * Push a new job onto the queue. * - * @param string $job - * @param mixed $data - * @param string|null $queue + * @param string $job + * @param mixed $data + * @param string|null $queue * @return mixed * @static */ @@ -8519,9 +8575,9 @@ public static function push($job, $data = '', $queue = null) /** * Push a raw payload onto the queue. * - * @param string $payload - * @param string|null $queue - * @param array $options + * @param string $payload + * @param string|null $queue + * @param array $options * @return mixed * @static */ @@ -8534,10 +8590,10 @@ public static function pushRaw($payload, $queue = null, $options = []) /** * Push a new job onto the queue after a delay. * - * @param \DateTimeInterface|\DateInterval|int $delay - * @param string $job - * @param mixed $data - * @param string|null $queue + * @param \DateTimeInterface|\DateInterval|int $delay + * @param string $job + * @param mixed $data + * @param string|null $queue * @return mixed * @static */ @@ -8550,9 +8606,9 @@ public static function later($delay, $job, $data = '', $queue = null) /** * Push a new job onto the queue. * - * @param string $queue - * @param string $job - * @param mixed $data + * @param string $queue + * @param string $job + * @param mixed $data * @return mixed * @static */ @@ -8565,10 +8621,10 @@ public static function pushOn($queue, $job, $data = '') /** * Push a new job onto the queue after a delay. * - * @param string $queue - * @param \DateTimeInterface|\DateInterval|int $delay - * @param string $job - * @param mixed $data + * @param string $queue + * @param \DateTimeInterface|\DateInterval|int $delay + * @param string $job + * @param mixed $data * @return mixed * @static */ @@ -8581,7 +8637,7 @@ public static function laterOn($queue, $delay, $job, $data = '') /** * Pop the next job off of the queue. * - * @param string|null $queue + * @param string|null $queue * @return \Illuminate\Contracts\Queue\Job|null * @static */ @@ -8594,9 +8650,9 @@ public static function pop($queue = null) /** * Push an array of jobs onto the queue. * - * @param array $jobs - * @param mixed $data - * @param string|null $queue + * @param array $jobs + * @param mixed $data + * @param string|null $queue * @return mixed * @static */ @@ -8633,7 +8689,7 @@ public static function getConnectionName() /** * Set the connection name for the queue. * - * @param string $name + * @param string $name * @return \Illuminate\Support\Testing\Fakes\QueueFake * @static */ @@ -8646,7 +8702,7 @@ public static function setConnectionName($name) /** * Get the backoff for an object-based queue handler. * - * @param mixed $job + * @param mixed $job * @return mixed * @static */ @@ -8659,7 +8715,7 @@ public static function getJobBackoff($job) /** * Get the expiration timestamp for an object-based queue handler. * - * @param mixed $job + * @param mixed $job * @return mixed * @static */ @@ -8672,7 +8728,7 @@ public static function getJobExpiration($job) /** * Register a callback to be executed when creating job payloads. * - * @param callable $callback + * @param callable $callback * @return void * @static */ @@ -8684,7 +8740,7 @@ public static function createPayloadUsing($callback) /** * Set the IoC container instance. * - * @param \Illuminate\Container\Container $container + * @param \Illuminate\Container\Container $container * @return void * @static */ @@ -8702,7 +8758,7 @@ class Redirect /** * Create a new redirect response to the "home" route. * - * @param int $status + * @param int $status * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8715,9 +8771,9 @@ public static function home($status = 302) /** * Create a new redirect response to the previous location. * - * @param int $status - * @param array $headers - * @param mixed $fallback + * @param int $status + * @param array $headers + * @param mixed $fallback * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8730,8 +8786,8 @@ public static function back($status = 302, $headers = [], $fallback = false) /** * Create a new redirect response to the current URI. * - * @param int $status - * @param array $headers + * @param int $status + * @param array $headers * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8744,10 +8800,10 @@ public static function refresh($status = 302, $headers = []) /** * Create a new redirect response, while putting the current URL in the session. * - * @param string $path - * @param int $status - * @param array $headers - * @param bool|null $secure + * @param string $path + * @param int $status + * @param array $headers + * @param bool|null $secure * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8760,10 +8816,10 @@ public static function guest($path, $status = 302, $headers = [], $secure = null /** * Create a new redirect response to the previously intended location. * - * @param string $default - * @param int $status - * @param array $headers - * @param bool|null $secure + * @param string $default + * @param int $status + * @param array $headers + * @param bool|null $secure * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8776,7 +8832,7 @@ public static function intended($default = '/', $status = 302, $headers = [], $s /** * Set the intended url. * - * @param string $url + * @param string $url * @return void * @static */ @@ -8789,10 +8845,10 @@ public static function setIntendedUrl($url) /** * Create a new redirect response to the given path. * - * @param string $path - * @param int $status - * @param array $headers - * @param bool|null $secure + * @param string $path + * @param int $status + * @param array $headers + * @param bool|null $secure * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8805,9 +8861,9 @@ public static function to($path, $status = 302, $headers = [], $secure = null) /** * Create a new redirect response to an external URL (no validation). * - * @param string $path - * @param int $status - * @param array $headers + * @param string $path + * @param int $status + * @param array $headers * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8820,9 +8876,9 @@ public static function away($path, $status = 302, $headers = []) /** * Create a new redirect response to the given HTTPS path. * - * @param string $path - * @param int $status - * @param array $headers + * @param string $path + * @param int $status + * @param array $headers * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8835,10 +8891,10 @@ public static function secure($path, $status = 302, $headers = []) /** * Create a new redirect response to a named route. * - * @param string $route - * @param mixed $parameters - * @param int $status - * @param array $headers + * @param string $route + * @param mixed $parameters + * @param int $status + * @param array $headers * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8851,11 +8907,11 @@ public static function route($route, $parameters = [], $status = 302, $headers = /** * Create a new redirect response to a signed named route. * - * @param string $route - * @param mixed $parameters - * @param \DateTimeInterface|\DateInterval|int|null $expiration - * @param int $status - * @param array $headers + * @param string $route + * @param mixed $parameters + * @param \DateTimeInterface|\DateInterval|int|null $expiration + * @param int $status + * @param array $headers * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8868,11 +8924,11 @@ public static function signedRoute($route, $parameters = [], $expiration = null, /** * Create a new redirect response to a signed named route. * - * @param string $route - * @param \DateTimeInterface|\DateInterval|int|null $expiration - * @param mixed $parameters - * @param int $status - * @param array $headers + * @param string $route + * @param \DateTimeInterface|\DateInterval|int|null $expiration + * @param mixed $parameters + * @param int $status + * @param array $headers * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8885,10 +8941,10 @@ public static function temporarySignedRoute($route, $expiration, $parameters = [ /** * Create a new redirect response to a controller action. * - * @param string|array $action - * @param mixed $parameters - * @param int $status - * @param array $headers + * @param string|array $action + * @param mixed $parameters + * @param int $status + * @param array $headers * @return \Illuminate\Http\RedirectResponse * @static */ @@ -8913,7 +8969,7 @@ public static function getUrlGenerator() /** * Set the active session store. * - * @param \Illuminate\Session\Store $session + * @param \Illuminate\Session\Store $session * @return void * @static */ @@ -8926,8 +8982,8 @@ public static function setSession($session) /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -8939,9 +8995,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -8953,7 +9010,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -8968,7 +9025,7 @@ class Redis /** * Get a Redis connection by name. * - * @param string|null $name + * @param string|null $name * @return \Illuminate\Redis\Connections\Connection * @static */ @@ -8981,8 +9038,9 @@ public static function connection($name = null) /** * Resolve the given connection by name. * - * @param string|null $name + * @param string|null $name * @return \Illuminate\Redis\Connections\Connection + * * @throws \InvalidArgumentException * @static */ @@ -9031,7 +9089,7 @@ public static function disableEvents() /** * Set the default driver. * - * @param string $driver + * @param string $driver * @return void * @static */ @@ -9044,7 +9102,7 @@ public static function setDriver($driver) /** * Disconnect the given connection and remove from local cache. * - * @param string|null $name + * @param string|null $name * @return void * @static */ @@ -9057,8 +9115,8 @@ public static function purge($name = null) /** * Register a custom driver creator Closure. * - * @param string $driver - * @param \Closure $callback + * @param string $driver + * @param \Closure $callback * @return \Illuminate\Redis\RedisManager * @static */ @@ -9070,6 +9128,7 @@ public static function extend($driver, $callback) } /** * @method static mixed filterFiles(mixed $files) + * * @see \Illuminate\Http\Request */ class Request @@ -9148,7 +9207,7 @@ public static function fullUrl() /** * Get the full URL for the request with the added query string parameters. * - * @param array $query + * @param array $query * @return string * @static */ @@ -9185,8 +9244,8 @@ public static function decodedPath() /** * Get a segment from the URI (1 based index). * - * @param int $index - * @param string|null $default + * @param int $index + * @param string|null $default * @return string|null * @static */ @@ -9211,7 +9270,7 @@ public static function segments() /** * Determine if the current request URI matches a pattern. * - * @param mixed $patterns + * @param mixed $patterns * @return bool * @static */ @@ -9224,7 +9283,7 @@ public static function is(...$patterns) /** * Determine if the route name matches a given pattern. * - * @param mixed $patterns + * @param mixed $patterns * @return bool * @static */ @@ -9237,7 +9296,7 @@ public static function routeIs(...$patterns) /** * Determine if the current request URL and query string matches a pattern. * - * @param mixed $patterns + * @param mixed $patterns * @return bool * @static */ @@ -9334,7 +9393,7 @@ public static function userAgent() /** * Merge new input into the current request's input array. * - * @param array $input + * @param array $input * @return \Illuminate\Http\Request * @static */ @@ -9347,7 +9406,7 @@ public static function merge($input) /** * Replace the input for the current request. * - * @param array $input + * @param array $input * @return \Illuminate\Http\Request * @static */ @@ -9362,8 +9421,8 @@ public static function replace($input) * * Instead, you may use the "input" method. * - * @param string $key - * @param mixed $default + * @param string $key + * @param mixed $default * @return mixed * @static */ @@ -9376,8 +9435,8 @@ public static function get($key, $default = null) /** * Get the JSON payload for the request. * - * @param string|null $key - * @param mixed $default + * @param string|null $key + * @param mixed $default * @return \Symfony\Component\HttpFoundation\ParameterBag|mixed * @static */ @@ -9390,8 +9449,8 @@ public static function json($key = null, $default = null) /** * Create a new request instance from the given Laravel request. * - * @param \Illuminate\Http\Request $from - * @param \Illuminate\Http\Request|null $to + * @param \Illuminate\Http\Request $from + * @param \Illuminate\Http\Request|null $to * @return static * @static */ @@ -9403,7 +9462,7 @@ public static function createFrom($from, $to = null) /** * Create an Illuminate request from a Symfony instance. * - * @param \Symfony\Component\HttpFoundation\Request $request + * @param \Symfony\Component\HttpFoundation\Request $request * @return static * @static */ @@ -9415,12 +9474,12 @@ public static function createFromBase($request) /** * Clones a request and overrides some of its parameters. * - * @param array $query The GET parameters - * @param array $request The POST parameters - * @param array $attributes The request attributes (parameters parsed from the PATH_INFO, ...) - * @param array $cookies The COOKIE parameters - * @param array $files The FILES parameters - * @param array $server The SERVER parameters + * @param array $query The GET parameters + * @param array $request The POST parameters + * @param array $attributes The request attributes (parameters parsed from the PATH_INFO, ...) + * @param array $cookies The COOKIE parameters + * @param array $files The FILES parameters + * @param array $server The SERVER parameters * @return static * @static */ @@ -9434,6 +9493,7 @@ public static function duplicate($query = null, $request = null, $attributes = n * Get the session associated with the request. * * @return \Illuminate\Session\Store + * * @throws \RuntimeException * @static */ @@ -9458,7 +9518,7 @@ public static function getSession() /** * Set the session instance on the request. * - * @param \Illuminate\Contracts\Session\Session $session + * @param \Illuminate\Contracts\Session\Session $session * @return void * @static */ @@ -9471,7 +9531,7 @@ public static function setLaravelSession($session) /** * Get the user making the request. * - * @param string|null $guard + * @param string|null $guard * @return mixed * @static */ @@ -9484,8 +9544,8 @@ public static function user($guard = null) /** * Get the route handling the request. * - * @param string|null $param - * @param mixed $default + * @param string|null $param + * @param mixed $default * @return \Illuminate\Routing\Route|object|string|null * @static */ @@ -9499,6 +9559,7 @@ public static function route($param = null, $default = null) * Get a unique fingerprint for the request / route / IP address. * * @return string + * * @throws \RuntimeException * @static */ @@ -9511,7 +9572,7 @@ public static function fingerprint() /** * Set the JSON payload for the request. * - * @param \Symfony\Component\HttpFoundation\ParameterBag $json + * @param \Symfony\Component\HttpFoundation\ParameterBag $json * @return \Illuminate\Http\Request * @static */ @@ -9536,7 +9597,7 @@ public static function getUserResolver() /** * Set the user resolver callback. * - * @param \Closure $callback + * @param \Closure $callback * @return \Illuminate\Http\Request * @static */ @@ -9561,7 +9622,7 @@ public static function getRouteResolver() /** * Set the route resolver callback. * - * @param \Closure $callback + * @param \Closure $callback * @return \Illuminate\Http\Request * @static */ @@ -9586,7 +9647,7 @@ public static function toArray() /** * Determine if the given offset exists. * - * @param string $offset + * @param string $offset * @return bool * @static */ @@ -9599,7 +9660,7 @@ public static function offsetExists($offset) /** * Get the value at the given offset. * - * @param string $offset + * @param string $offset * @return mixed * @static */ @@ -9612,8 +9673,8 @@ public static function offsetGet($offset) /** * Set the value at the given offset. * - * @param string $offset - * @param mixed $value + * @param string $offset + * @param mixed $value * @return void * @static */ @@ -9626,7 +9687,7 @@ public static function offsetSet($offset, $value) /** * Remove the value at the given offset. * - * @param string $offset + * @param string $offset * @return void * @static */ @@ -9641,13 +9702,13 @@ public static function offsetUnset($offset) * * This method also re-initializes all properties. * - * @param array $query The GET parameters - * @param array $request The POST parameters - * @param array $attributes The request attributes (parameters parsed from the PATH_INFO, ...) - * @param array $cookies The COOKIE parameters - * @param array $files The FILES parameters - * @param array $server The SERVER parameters - * @param string|resource|null $content The raw body data + * @param array $query The GET parameters + * @param array $request The POST parameters + * @param array $attributes The request attributes (parameters parsed from the PATH_INFO, ...) + * @param array $cookies The COOKIE parameters + * @param array $files The FILES parameters + * @param array $server The SERVER parameters + * @param string|resource|null $content The raw body data * @static */ public static function initialize($query = [], $request = [], $attributes = [], $cookies = [], $files = [], $server = [], $content = null) @@ -9673,13 +9734,13 @@ public static function createFromGlobals() * The information contained in the URI always take precedence * over the other information (server and parameters). * - * @param string $uri The URI - * @param string $method The HTTP method - * @param array $parameters The query (GET) or request (POST) parameters - * @param array $cookies The request cookies ($_COOKIE) - * @param array $files The request files ($_FILES) - * @param array $server The server parameters ($_SERVER) - * @param string|resource|null $content The raw body data + * @param string $uri The URI + * @param string $method The HTTP method + * @param array $parameters The query (GET) or request (POST) parameters + * @param array $cookies The request cookies ($_COOKIE) + * @param array $files The request files ($_FILES) + * @param array $server The server parameters ($_SERVER) + * @param string|resource|null $content The raw body data * @return static * @static */ @@ -9721,8 +9782,9 @@ public static function overrideGlobals() * * You should only list the reverse proxies that you manage directly. * - * @param array $proxies A list of trusted proxies, the string 'REMOTE_ADDR' will be replaced with $_SERVER['REMOTE_ADDR'] - * @param int $trustedHeaderSet A bit field of Request::HEADER_*, to set which headers to trust from your proxies + * @param array $proxies A list of trusted proxies, the string 'REMOTE_ADDR' will be replaced with $_SERVER['REMOTE_ADDR'] + * @param int $trustedHeaderSet A bit field of Request::HEADER_*, to set which headers to trust from your proxies + * * @throws \InvalidArgumentException When $trustedHeaderSet is invalid * @static */ @@ -9758,7 +9820,7 @@ public static function getTrustedHeaderSet() * * You should only list the hosts you manage using regexs. * - * @param array $hostPatterns A list of trusted host patterns + * @param array $hostPatterns A list of trusted host patterns * @static */ public static function setTrustedHosts($hostPatterns) @@ -9878,6 +9940,7 @@ public static function setSessionFactory($factory) * Use this method carefully; you should use getClientIp() instead. * * @return array The client IP addresses + * * @see getClientIp() * @static */ @@ -9901,6 +9964,7 @@ public static function getClientIps() * argument of the Request::setTrustedProxies() method instead. * * @return string|null The client IP address + * * @see getClientIps() * @see https://wikipedia.org/wiki/X-Forwarded-For * @static @@ -10090,6 +10154,7 @@ public static function getSchemeAndHttpHost() * Generates a normalized URI (URL) for the Request. * * @return string A normalized URI (URL) for the Request + * * @see getQueryString() * @static */ @@ -10102,7 +10167,7 @@ public static function getUri() /** * Generates a normalized URI for the given path. * - * @param string $path A path to use instead of the current one + * @param string $path A path to use instead of the current one * @return string The normalized URI for the path * @static */ @@ -10177,6 +10242,7 @@ public static function isSecure() * The "X-Forwarded-Host" header must contain the client host name. * * @return string + * * @throws SuspiciousOperationException when the host name is invalid or not trusted * @static */ @@ -10209,6 +10275,7 @@ public static function setMethod($method) * The method is always an uppercased string. * * @return string The request method + * * @see getRealMethod() * @static */ @@ -10222,6 +10289,7 @@ public static function getMethod() * Gets the "real" request method. * * @return string The request method + * * @see getMethod() * @static */ @@ -10269,7 +10337,7 @@ public static function getFormat($mimeType) /** * Associates a format with mime types. * - * @param string|array $mimeTypes The associated mime types (the preferred one must be the first as it will be used as the content type) + * @param string|array $mimeTypes The associated mime types (the preferred one must be the first as it will be used as the content type) * @static */ public static function setFormat($format, $mimeTypes) @@ -10288,6 +10356,7 @@ public static function setFormat($format, $mimeTypes) * * $default * * @see getPreferredFormat + * * @return string|null The request format * @static */ @@ -10369,7 +10438,7 @@ public static function getLocale() /** * Checks if the request method is of specified type. * - * @param string $method Uppercase request method (GET, POST etc) + * @param string $method Uppercase request method (GET, POST etc) * @return bool * @static */ @@ -10383,6 +10452,7 @@ public static function isMethod($method) * Checks whether or not the method is safe. * * @see https://tools.ietf.org/html/rfc7231#section-4.2.1 + * * @return bool * @static */ @@ -10408,6 +10478,7 @@ public static function isMethodIdempotent() * Checks whether the method is cacheable or not. * * @see https://tools.ietf.org/html/rfc7231#section-4.2.3 + * * @return bool True for GET and HEAD, false otherwise * @static */ @@ -10438,8 +10509,9 @@ public static function getProtocolVersion() /** * Returns the request body content. * - * @param bool $asResource If true, a resource will be returned + * @param bool $asResource If true, a resource will be returned * @return string|resource The request body content or a resource to read the body stream + * * @throws \LogicException * @static */ @@ -10490,7 +10562,7 @@ public static function getPreferredFormat($default = 'html') /** * Returns the preferred language. * - * @param string[] $locales An array of ordered available locales + * @param string[] $locales An array of ordered available locales * @return string|null The preferred locale * @static */ @@ -10555,6 +10627,7 @@ public static function getAcceptableContentTypes() * It is known to work with common JavaScript frameworks: * * @see https://wikipedia.org/wiki/List_of_Ajax_frameworks#JavaScript + * * @return bool true if the request is an XMLHttpRequest, false otherwise * @static */ @@ -10594,8 +10667,8 @@ public static function isFromTrustedProxy() /** * Determine if the given content types match. * - * @param string $actual - * @param string $type + * @param string $actual + * @param string $type * @return bool * @static */ @@ -10643,7 +10716,7 @@ public static function wantsJson() /** * Determines whether the current requests accepts a given content type. * - * @param string|array $contentTypes + * @param string|array $contentTypes * @return bool * @static */ @@ -10656,7 +10729,7 @@ public static function accepts($contentTypes) /** * Return the most suitable content type from the given array based on content negotiation. * - * @param string|array $contentTypes + * @param string|array $contentTypes * @return string|null * @static */ @@ -10705,7 +10778,7 @@ public static function acceptsHtml() /** * Get the data format expected in the response. * - * @param string $default + * @param string $default * @return string * @static */ @@ -10718,8 +10791,8 @@ public static function format($default = 'html') /** * Retrieve an old input item. * - * @param string|null $key - * @param string|array|null $default + * @param string|null $key + * @param string|array|null $default * @return string|array * @static */ @@ -10744,7 +10817,7 @@ public static function flash() /** * Flash only some of the input to the session. * - * @param array|mixed $keys + * @param array|mixed $keys * @return void * @static */ @@ -10757,7 +10830,7 @@ public static function flashOnly($keys) /** * Flash only some of the input to the session. * - * @param array|mixed $keys + * @param array|mixed $keys * @return void * @static */ @@ -10782,8 +10855,8 @@ public static function flush() /** * Retrieve a server variable from the request. * - * @param string|null $key - * @param string|array|null $default + * @param string|null $key + * @param string|array|null $default * @return string|array|null * @static */ @@ -10796,7 +10869,7 @@ public static function server($key = null, $default = null) /** * Determine if a header is set on the request. * - * @param string $key + * @param string $key * @return bool * @static */ @@ -10809,8 +10882,8 @@ public static function hasHeader($key) /** * Retrieve a header from the request. * - * @param string|null $key - * @param string|array|null $default + * @param string|null $key + * @param string|array|null $default * @return string|array|null * @static */ @@ -10835,7 +10908,7 @@ public static function bearerToken() /** * Determine if the request contains a given input item key. * - * @param string|array $key + * @param string|array $key * @return bool * @static */ @@ -10848,7 +10921,7 @@ public static function exists($key) /** * Determine if the request contains a given input item key. * - * @param string|array $key + * @param string|array $key * @return bool * @static */ @@ -10861,7 +10934,7 @@ public static function has($key) /** * Determine if the request contains any of the given inputs. * - * @param string|array $keys + * @param string|array $keys * @return bool * @static */ @@ -10874,8 +10947,8 @@ public static function hasAny($keys) /** * Apply the callback if the request contains the given input item key. * - * @param string $key - * @param callable $callback + * @param string $key + * @param callable $callback * @return $this|mixed * @static */ @@ -10888,7 +10961,7 @@ public static function whenHas($key, $callback) /** * Determine if the request contains a non-empty value for an input item. * - * @param string|array $key + * @param string|array $key * @return bool * @static */ @@ -10901,7 +10974,7 @@ public static function filled($key) /** * Determine if the request contains an empty value for an input item. * - * @param string|array $key + * @param string|array $key * @return bool * @static */ @@ -10914,7 +10987,7 @@ public static function isNotFilled($key) /** * Determine if the request contains a non-empty value for any of the given inputs. * - * @param string|array $keys + * @param string|array $keys * @return bool * @static */ @@ -10927,8 +11000,8 @@ public static function anyFilled($keys) /** * Apply the callback if the request contains a non-empty value for the given input item key. * - * @param string $key - * @param callable $callback + * @param string $key + * @param callable $callback * @return $this|mixed * @static */ @@ -10941,7 +11014,7 @@ public static function whenFilled($key, $callback) /** * Determine if the request is missing a given input item key. * - * @param string|array $key + * @param string|array $key * @return bool * @static */ @@ -10966,7 +11039,7 @@ public static function keys() /** * Get all of the input and files for the request. * - * @param array|mixed|null $keys + * @param array|mixed|null $keys * @return array * @static */ @@ -10979,8 +11052,8 @@ public static function all($keys = null) /** * Retrieve an input item from the request. * - * @param string|null $key - * @param mixed $default + * @param string|null $key + * @param mixed $default * @return mixed * @static */ @@ -10995,8 +11068,8 @@ public static function input($key = null, $default = null) * * Returns true when value is "1", "true", "on", and "yes". Otherwise, returns false. * - * @param string|null $key - * @param bool $default + * @param string|null $key + * @param bool $default * @return bool * @static */ @@ -11009,7 +11082,7 @@ public static function boolean($key = null, $default = false) /** * Get a subset containing the provided keys with values from the input data. * - * @param array|mixed $keys + * @param array|mixed $keys * @return array * @static */ @@ -11022,7 +11095,7 @@ public static function only($keys) /** * Get all of the input except for a specified array of items. * - * @param array|mixed $keys + * @param array|mixed $keys * @return array * @static */ @@ -11035,8 +11108,8 @@ public static function except($keys) /** * Retrieve a query string item from the request. * - * @param string|null $key - * @param string|array|null $default + * @param string|null $key + * @param string|array|null $default * @return string|array|null * @static */ @@ -11049,8 +11122,8 @@ public static function query($key = null, $default = null) /** * Retrieve a request payload item from the request. * - * @param string|null $key - * @param string|array|null $default + * @param string|null $key + * @param string|array|null $default * @return string|array|null * @static */ @@ -11063,7 +11136,7 @@ public static function post($key = null, $default = null) /** * Determine if a cookie is set on the request. * - * @param string $key + * @param string $key * @return bool * @static */ @@ -11076,8 +11149,8 @@ public static function hasCookie($key) /** * Retrieve a cookie from the request. * - * @param string|null $key - * @param string|array|null $default + * @param string|null $key + * @param string|array|null $default * @return string|array|null * @static */ @@ -11102,7 +11175,7 @@ public static function allFiles() /** * Determine if the uploaded data contains a file. * - * @param string $key + * @param string $key * @return bool * @static */ @@ -11115,8 +11188,8 @@ public static function hasFile($key) /** * Retrieve a file from the request. * - * @param string|null $key - * @param mixed $default + * @param string|null $key + * @param mixed $default * @return \Illuminate\Http\UploadedFile|\Illuminate\Http\UploadedFile[]|array|null * @static */ @@ -11129,8 +11202,8 @@ public static function file($key = null, $default = null) /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -11142,9 +11215,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -11156,7 +11230,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -11166,8 +11240,8 @@ public static function hasMacro($name) } /** - * @param array $rules - * @param mixed $params + * @param array $rules + * @param mixed $params * @static */ public static function validate($rules, ...$params) @@ -11176,9 +11250,9 @@ public static function validate($rules, ...$params) } /** - * @param string $errorBag - * @param array $rules - * @param mixed $params + * @param string $errorBag + * @param array $rules + * @param mixed $params * @static */ public static function validateWithBag($errorBag, $rules, ...$params) @@ -11187,7 +11261,7 @@ public static function validateWithBag($errorBag, $rules, ...$params) } /** - * @param mixed $absolute + * @param mixed $absolute * @static */ public static function hasValidSignature($absolute = true) @@ -11211,9 +11285,9 @@ class Response /** * Create a new response instance. * - * @param string $content - * @param int $status - * @param array $headers + * @param string $content + * @param int $status + * @param array $headers * @return \Illuminate\Http\Response * @static */ @@ -11226,8 +11300,8 @@ public static function make($content = '', $status = 200, $headers = []) /** * Create a new "no content" response. * - * @param int $status - * @param array $headers + * @param int $status + * @param array $headers * @return \Illuminate\Http\Response * @static */ @@ -11240,10 +11314,10 @@ public static function noContent($status = 204, $headers = []) /** * Create a new response for a given view. * - * @param string|array $view - * @param array $data - * @param int $status - * @param array $headers + * @param string|array $view + * @param array $data + * @param int $status + * @param array $headers * @return \Illuminate\Http\Response * @static */ @@ -11256,10 +11330,10 @@ public static function view($view, $data = [], $status = 200, $headers = []) /** * Create a new JSON response instance. * - * @param mixed $data - * @param int $status - * @param array $headers - * @param int $options + * @param mixed $data + * @param int $status + * @param array $headers + * @param int $options * @return \Illuminate\Http\JsonResponse * @static */ @@ -11272,11 +11346,11 @@ public static function json($data = [], $status = 200, $headers = [], $options = /** * Create a new JSONP response instance. * - * @param string $callback - * @param mixed $data - * @param int $status - * @param array $headers - * @param int $options + * @param string $callback + * @param mixed $data + * @param int $status + * @param array $headers + * @param int $options * @return \Illuminate\Http\JsonResponse * @static */ @@ -11289,9 +11363,9 @@ public static function jsonp($callback, $data = [], $status = 200, $headers = [] /** * Create a new streamed response instance. * - * @param \Closure $callback - * @param int $status - * @param array $headers + * @param \Closure $callback + * @param int $status + * @param array $headers * @return \Symfony\Component\HttpFoundation\StreamedResponse * @static */ @@ -11304,10 +11378,10 @@ public static function stream($callback, $status = 200, $headers = []) /** * Create a new streamed response instance as a file download. * - * @param \Closure $callback - * @param string|null $name - * @param array $headers - * @param string|null $disposition + * @param \Closure $callback + * @param string|null $name + * @param array $headers + * @param string|null $disposition * @return \Symfony\Component\HttpFoundation\StreamedResponse * @static */ @@ -11320,10 +11394,10 @@ public static function streamDownload($callback, $name = null, $headers = [], $d /** * Create a new file download response. * - * @param \SplFileInfo|string $file - * @param string|null $name - * @param array $headers - * @param string|null $disposition + * @param \SplFileInfo|string $file + * @param string|null $name + * @param array $headers + * @param string|null $disposition * @return \Symfony\Component\HttpFoundation\BinaryFileResponse * @static */ @@ -11336,8 +11410,8 @@ public static function download($file, $name = null, $headers = [], $disposition /** * Return the raw contents of a binary file. * - * @param \SplFileInfo|string $file - * @param array $headers + * @param \SplFileInfo|string $file + * @param array $headers * @return \Symfony\Component\HttpFoundation\BinaryFileResponse * @static */ @@ -11350,10 +11424,10 @@ public static function file($file, $headers = []) /** * Create a new redirect response to the given path. * - * @param string $path - * @param int $status - * @param array $headers - * @param bool|null $secure + * @param string $path + * @param int $status + * @param array $headers + * @param bool|null $secure * @return \Illuminate\Http\RedirectResponse * @static */ @@ -11366,10 +11440,10 @@ public static function redirectTo($path, $status = 302, $headers = [], $secure = /** * Create a new redirect response to a named route. * - * @param string $route - * @param mixed $parameters - * @param int $status - * @param array $headers + * @param string $route + * @param mixed $parameters + * @param int $status + * @param array $headers * @return \Illuminate\Http\RedirectResponse * @static */ @@ -11382,10 +11456,10 @@ public static function redirectToRoute($route, $parameters = [], $status = 302, /** * Create a new redirect response to a controller action. * - * @param string $action - * @param mixed $parameters - * @param int $status - * @param array $headers + * @param string $action + * @param mixed $parameters + * @param int $status + * @param array $headers * @return \Illuminate\Http\RedirectResponse * @static */ @@ -11398,10 +11472,10 @@ public static function redirectToAction($action, $parameters = [], $status = 302 /** * Create a new redirect response, while putting the current URL in the session. * - * @param string $path - * @param int $status - * @param array $headers - * @param bool|null $secure + * @param string $path + * @param int $status + * @param array $headers + * @param bool|null $secure * @return \Illuminate\Http\RedirectResponse * @static */ @@ -11414,10 +11488,10 @@ public static function redirectGuest($path, $status = 302, $headers = [], $secur /** * Create a new redirect response to the previously intended location. * - * @param string $default - * @param int $status - * @param array $headers - * @param bool|null $secure + * @param string $default + * @param int $status + * @param array $headers + * @param bool|null $secure * @return \Illuminate\Http\RedirectResponse * @static */ @@ -11430,8 +11504,8 @@ public static function redirectToIntended($default = '/', $status = 302, $header /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -11443,9 +11517,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -11457,7 +11532,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -11474,6 +11549,7 @@ public static function hasMacro($name) * @method static \Illuminate\Routing\RouteRegistrar namespace(string $value) * @method static \Illuminate\Routing\RouteRegistrar prefix(string $prefix) * @method static \Illuminate\Routing\RouteRegistrar where(array $where) + * * @see \Illuminate\Routing\Router */ class Route @@ -11481,8 +11557,8 @@ class Route /** * Register a new GET route with the router. * - * @param string $uri - * @param array|string|callable|null $action + * @param string $uri + * @param array|string|callable|null $action * @return \Illuminate\Routing\Route * @static */ @@ -11495,8 +11571,8 @@ public static function get($uri, $action = null) /** * Register a new POST route with the router. * - * @param string $uri - * @param array|string|callable|null $action + * @param string $uri + * @param array|string|callable|null $action * @return \Illuminate\Routing\Route * @static */ @@ -11509,8 +11585,8 @@ public static function post($uri, $action = null) /** * Register a new PUT route with the router. * - * @param string $uri - * @param array|string|callable|null $action + * @param string $uri + * @param array|string|callable|null $action * @return \Illuminate\Routing\Route * @static */ @@ -11523,8 +11599,8 @@ public static function put($uri, $action = null) /** * Register a new PATCH route with the router. * - * @param string $uri - * @param array|string|callable|null $action + * @param string $uri + * @param array|string|callable|null $action * @return \Illuminate\Routing\Route * @static */ @@ -11537,8 +11613,8 @@ public static function patch($uri, $action = null) /** * Register a new DELETE route with the router. * - * @param string $uri - * @param array|string|callable|null $action + * @param string $uri + * @param array|string|callable|null $action * @return \Illuminate\Routing\Route * @static */ @@ -11551,8 +11627,8 @@ public static function delete($uri, $action = null) /** * Register a new OPTIONS route with the router. * - * @param string $uri - * @param array|string|callable|null $action + * @param string $uri + * @param array|string|callable|null $action * @return \Illuminate\Routing\Route * @static */ @@ -11565,8 +11641,8 @@ public static function options($uri, $action = null) /** * Register a new route responding to all verbs. * - * @param string $uri - * @param array|string|callable|null $action + * @param string $uri + * @param array|string|callable|null $action * @return \Illuminate\Routing\Route * @static */ @@ -11579,7 +11655,7 @@ public static function any($uri, $action = null) /** * Register a new Fallback route with the router. * - * @param array|string|callable|null $action + * @param array|string|callable|null $action * @return \Illuminate\Routing\Route * @static */ @@ -11592,9 +11668,9 @@ public static function fallback($action) /** * Create a redirect from one URI to another. * - * @param string $uri - * @param string $destination - * @param int $status + * @param string $uri + * @param string $destination + * @param int $status * @return \Illuminate\Routing\Route * @static */ @@ -11607,8 +11683,8 @@ public static function redirect($uri, $destination, $status = 302) /** * Create a permanent redirect from one URI to another. * - * @param string $uri - * @param string $destination + * @param string $uri + * @param string $destination * @return \Illuminate\Routing\Route * @static */ @@ -11621,11 +11697,11 @@ public static function permanentRedirect($uri, $destination) /** * Register a new route that returns a view. * - * @param string $uri - * @param string $view - * @param array $data - * @param int|array $status - * @param array $headers + * @param string $uri + * @param string $view + * @param array $data + * @param int|array $status + * @param array $headers * @return \Illuminate\Routing\Route * @static */ @@ -11638,9 +11714,9 @@ public static function view($uri, $view, $data = [], $status = 200, $headers = [ /** * Register a new route with the given verbs. * - * @param array|string $methods - * @param string $uri - * @param array|string|callable|null $action + * @param array|string $methods + * @param string $uri + * @param array|string|callable|null $action * @return \Illuminate\Routing\Route * @static */ @@ -11653,8 +11729,8 @@ public static function match($methods, $uri, $action = null) /** * Register an array of resource controllers. * - * @param array $resources - * @param array $options + * @param array $resources + * @param array $options * @return void * @static */ @@ -11667,9 +11743,9 @@ public static function resources($resources, $options = []) /** * Route a resource to a controller. * - * @param string $name - * @param string $controller - * @param array $options + * @param string $name + * @param string $controller + * @param array $options * @return \Illuminate\Routing\PendingResourceRegistration * @static */ @@ -11682,8 +11758,8 @@ public static function resource($name, $controller, $options = []) /** * Register an array of API resource controllers. * - * @param array $resources - * @param array $options + * @param array $resources + * @param array $options * @return void * @static */ @@ -11696,9 +11772,9 @@ public static function apiResources($resources, $options = []) /** * Route an API resource to a controller. * - * @param string $name - * @param string $controller - * @param array $options + * @param string $name + * @param string $controller + * @param array $options * @return \Illuminate\Routing\PendingResourceRegistration * @static */ @@ -11711,8 +11787,8 @@ public static function apiResource($name, $controller, $options = []) /** * Create a route group with shared attributes. * - * @param array $attributes - * @param \Closure|string $routes + * @param array $attributes + * @param \Closure|string $routes * @return void * @static */ @@ -11725,8 +11801,8 @@ public static function group($attributes, $routes) /** * Merge the given array with the last group stack. * - * @param array $new - * @param bool $prependExistingPrefix + * @param array $new + * @param bool $prependExistingPrefix * @return array * @static */ @@ -11751,9 +11827,9 @@ public static function getLastGroupPrefix() /** * Add a route to the underlying route collection. * - * @param array|string $methods - * @param string $uri - * @param array|string|callable|null $action + * @param array|string $methods + * @param string $uri + * @param array|string|callable|null $action * @return \Illuminate\Routing\Route * @static */ @@ -11766,9 +11842,9 @@ public static function addRoute($methods, $uri, $action) /** * Create a new Route object. * - * @param array|string $methods - * @param string $uri - * @param mixed $action + * @param array|string $methods + * @param string $uri + * @param mixed $action * @return \Illuminate\Routing\Route * @static */ @@ -11781,7 +11857,7 @@ public static function newRoute($methods, $uri, $action) /** * Return the response returned by the given route. * - * @param string $name + * @param string $name * @return \Symfony\Component\HttpFoundation\Response * @static */ @@ -11794,7 +11870,7 @@ public static function respondWithRoute($name) /** * Dispatch the request to the application. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return \Symfony\Component\HttpFoundation\Response * @static */ @@ -11807,7 +11883,7 @@ public static function dispatch($request) /** * Dispatch the request to a route and return the response. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return \Symfony\Component\HttpFoundation\Response * @static */ @@ -11820,7 +11896,7 @@ public static function dispatchToRoute($request) /** * Gather the middleware for the given route with resolved class names. * - * @param \Illuminate\Routing\Route $route + * @param \Illuminate\Routing\Route $route * @return array * @static */ @@ -11833,8 +11909,8 @@ public static function gatherRouteMiddleware($route) /** * Create a response instance from the given value. * - * @param \Symfony\Component\HttpFoundation\Request $request - * @param mixed $response + * @param \Symfony\Component\HttpFoundation\Request $request + * @param mixed $response * @return \Symfony\Component\HttpFoundation\Response * @static */ @@ -11847,8 +11923,8 @@ public static function prepareResponse($request, $response) /** * Static version of prepareResponse. * - * @param \Symfony\Component\HttpFoundation\Request $request - * @param mixed $response + * @param \Symfony\Component\HttpFoundation\Request $request + * @param mixed $response * @return \Symfony\Component\HttpFoundation\Response * @static */ @@ -11860,8 +11936,9 @@ public static function toResponse($request, $response) /** * Substitute the route bindings onto the route. * - * @param \Illuminate\Routing\Route $route + * @param \Illuminate\Routing\Route $route * @return \Illuminate\Routing\Route + * * @throws \Illuminate\Database\Eloquent\ModelNotFoundException * @static */ @@ -11874,8 +11951,9 @@ public static function substituteBindings($route) /** * Substitute the implicit Eloquent model bindings for the route. * - * @param \Illuminate\Routing\Route $route + * @param \Illuminate\Routing\Route $route * @return void + * * @throws \Illuminate\Database\Eloquent\ModelNotFoundException * @static */ @@ -11888,7 +11966,7 @@ public static function substituteImplicitBindings($route) /** * Register a route matched event listener. * - * @param string|callable $callback + * @param string|callable $callback * @return void * @static */ @@ -11913,8 +11991,8 @@ public static function getMiddleware() /** * Register a short-hand name for a middleware. * - * @param string $name - * @param string $class + * @param string $name + * @param string $class * @return \Illuminate\Routing\Router * @static */ @@ -11927,7 +12005,7 @@ public static function aliasMiddleware($name, $class) /** * Check if a middlewareGroup with the given name exists. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -11952,8 +12030,8 @@ public static function getMiddlewareGroups() /** * Register a group of middleware. * - * @param string $name - * @param array $middleware + * @param string $name + * @param array $middleware * @return \Illuminate\Routing\Router * @static */ @@ -11968,8 +12046,8 @@ public static function middlewareGroup($name, $middleware) * * If the middleware is already in the group, it will not be added again. * - * @param string $group - * @param string $middleware + * @param string $group + * @param string $middleware * @return \Illuminate\Routing\Router * @static */ @@ -11984,8 +12062,8 @@ public static function prependMiddlewareToGroup($group, $middleware) * * If the middleware is already in the group, it will not be added again. * - * @param string $group - * @param string $middleware + * @param string $group + * @param string $middleware * @return \Illuminate\Routing\Router * @static */ @@ -11998,8 +12076,8 @@ public static function pushMiddlewareToGroup($group, $middleware) /** * Add a new route parameter binder. * - * @param string $key - * @param string|callable $binder + * @param string $key + * @param string|callable $binder * @return void * @static */ @@ -12012,9 +12090,9 @@ public static function bind($key, $binder) /** * Register a model binder for a wildcard. * - * @param string $key - * @param string $class - * @param \Closure|null $callback + * @param string $key + * @param string $class + * @param \Closure|null $callback * @return void * @static */ @@ -12027,7 +12105,7 @@ public static function model($key, $class, $callback = null) /** * Get the binding callback for a given binding. * - * @param string $key + * @param string $key * @return \Closure|null * @static */ @@ -12052,8 +12130,8 @@ public static function getPatterns() /** * Set a global where pattern on all routes. * - * @param string $key - * @param string $pattern + * @param string $key + * @param string $pattern * @return void * @static */ @@ -12066,7 +12144,7 @@ public static function pattern($key, $pattern) /** * Set a group of global where patterns on all routes. * - * @param array $patterns + * @param array $patterns * @return void * @static */ @@ -12103,8 +12181,8 @@ public static function getGroupStack() /** * Get a route parameter for the current route. * - * @param string $key - * @param string|null $default + * @param string $key + * @param string|null $default * @return mixed * @static */ @@ -12153,7 +12231,7 @@ public static function current() /** * Check if a route with the given name exists. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -12178,7 +12256,7 @@ public static function currentRouteName() /** * Alias for the "currentRouteNamed" method. * - * @param mixed $patterns + * @param mixed $patterns * @return bool * @static */ @@ -12191,7 +12269,7 @@ public static function is(...$patterns) /** * Determine if the current route matches a pattern. * - * @param mixed $patterns + * @param mixed $patterns * @return bool * @static */ @@ -12216,7 +12294,7 @@ public static function currentRouteAction() /** * Alias for the "currentRouteUses" method. * - * @param array $patterns + * @param array $patterns * @return bool * @static */ @@ -12229,7 +12307,7 @@ public static function uses(...$patterns) /** * Determine if the current route action matches a given action. * - * @param string $action + * @param string $action * @return bool * @static */ @@ -12242,7 +12320,7 @@ public static function currentRouteUses($action) /** * Set the unmapped global resource parameters to singular. * - * @param bool $singular + * @param bool $singular * @return void * @static */ @@ -12255,7 +12333,7 @@ public static function singularResourceParameters($singular = true) /** * Set the global resource parameter mapping. * - * @param array $parameters + * @param array $parameters * @return void * @static */ @@ -12268,7 +12346,7 @@ public static function resourceParameters($parameters = []) /** * Get or set the verbs used in the resource URIs. * - * @param array $verbs + * @param array $verbs * @return array|null * @static */ @@ -12293,7 +12371,7 @@ public static function getRoutes() /** * Set the route collection instance. * - * @param \Illuminate\Routing\RouteCollection $routes + * @param \Illuminate\Routing\RouteCollection $routes * @return void * @static */ @@ -12306,7 +12384,7 @@ public static function setRoutes($routes) /** * Set the compiled route collection instance. * - * @param array $routes + * @param array $routes * @return void * @static */ @@ -12319,7 +12397,7 @@ public static function setCompiledRoutes($routes) /** * Remove any duplicate middleware from the given array. * - * @param array $middleware + * @param array $middleware * @return array * @static */ @@ -12331,8 +12409,8 @@ public static function uniqueMiddleware($middleware) /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -12344,9 +12422,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -12358,7 +12437,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -12370,9 +12449,10 @@ public static function hasMacro($name) /** * Dynamically handle calls to the class. * - * @param string $method - * @param array $parameters + * @param string $method + * @param array $parameters * @return mixed + * * @throws \BadMethodCallException * @static */ @@ -12383,7 +12463,7 @@ public static function macroCall($method, $parameters) } /** - * @param mixed $options + * @param mixed $options * @static */ public static function auth($options = []) @@ -12423,7 +12503,7 @@ class Schema /** * Determine if the given table exists. * - * @param string $table + * @param string $table * @return bool * @static */ @@ -12436,7 +12516,7 @@ public static function hasTable($table) /** * Get the column listing for a given table. * - * @param string $table + * @param string $table * @return array * @static */ @@ -12497,7 +12577,7 @@ public static function getAllViews() /** * Set the default string length for migrations. * - * @param int $length + * @param int $length * @return void * @static */ @@ -12509,7 +12589,7 @@ public static function defaultStringLength($length) /** * Set the default morph key type for migrations. * - * @param string $type + * @param string $type * @return void * @static */ @@ -12532,8 +12612,8 @@ public static function morphUsingUuids() /** * Determine if the given table has a given column. * - * @param string $table - * @param string $column + * @param string $table + * @param string $column * @return bool * @static */ @@ -12546,8 +12626,8 @@ public static function hasColumn($table, $column) /** * Determine if the given table has given columns. * - * @param string $table - * @param array $columns + * @param string $table + * @param array $columns * @return bool * @static */ @@ -12560,8 +12640,8 @@ public static function hasColumns($table, $columns) /** * Get the data type for the given column name. * - * @param string $table - * @param string $column + * @param string $table + * @param string $column * @return string * @static */ @@ -12574,8 +12654,8 @@ public static function getColumnType($table, $column) /** * Modify a table on the schema. * - * @param string $table - * @param \Closure $callback + * @param string $table + * @param \Closure $callback * @return void * @static */ @@ -12588,8 +12668,8 @@ public static function table($table, $callback) /** * Create a new table on the schema. * - * @param string $table - * @param \Closure $callback + * @param string $table + * @param \Closure $callback * @return void * @static */ @@ -12602,7 +12682,7 @@ public static function create($table, $callback) /** * Drop a table from the schema. * - * @param string $table + * @param string $table * @return void * @static */ @@ -12615,7 +12695,7 @@ public static function drop($table) /** * Drop a table from the schema if it exists. * - * @param string $table + * @param string $table * @return void * @static */ @@ -12628,8 +12708,8 @@ public static function dropIfExists($table) /** * Drop columns from a table schema. * - * @param string $table - * @param string|array $columns + * @param string $table + * @param string|array $columns * @return void * @static */ @@ -12643,6 +12723,7 @@ public static function dropColumns($table, $columns) * Drop all types from the database. * * @return void + * * @throws \LogicException * @static */ @@ -12655,8 +12736,8 @@ public static function dropAllTypes() /** * Rename a table on the schema. * - * @param string $from - * @param string $to + * @param string $from + * @param string $to * @return void * @static */ @@ -12693,10 +12774,11 @@ public static function disableForeignKeyConstraints() /** * Register a custom Doctrine mapping type. * - * @param string $class - * @param string $name - * @param string $type + * @param string $class + * @param string $name + * @param string $type * @return void + * * @throws \Doctrine\DBAL\DBALException * @throws \RuntimeException * @static @@ -12722,7 +12804,7 @@ public static function getConnection() /** * Set the database connection instance. * - * @param \Illuminate\Database\Connection $connection + * @param \Illuminate\Database\Connection $connection * @return \Illuminate\Database\Schema\MySqlBuilder * @static */ @@ -12735,7 +12817,7 @@ public static function setConnection($connection) /** * Set the Schema Blueprint resolver callback. * - * @param \Closure $resolver + * @param \Closure $resolver * @return void * @static */ @@ -12802,7 +12884,7 @@ public static function getDefaultDriver() /** * Set the default session driver name. * - * @param string $name + * @param string $name * @return void * @static */ @@ -12815,8 +12897,9 @@ public static function setDefaultDriver($name) /** * Get a driver instance. * - * @param string|null $driver + * @param string|null $driver * @return mixed + * * @throws \InvalidArgumentException * @static */ @@ -12829,8 +12912,8 @@ public static function driver($driver = null) /** * Register a custom driver creator Closure. * - * @param string $driver - * @param \Closure $callback + * @param string $driver + * @param \Closure $callback * @return \Illuminate\Session\SessionManager * @static */ @@ -12903,7 +12986,7 @@ public static function all() /** * Get a subset of the session data. * - * @param array $keys + * @param array $keys * @return array * @static */ @@ -12916,7 +12999,7 @@ public static function only($keys) /** * Checks if a key exists. * - * @param string|array $key + * @param string|array $key * @return bool * @static */ @@ -12929,7 +13012,7 @@ public static function exists($key) /** * Checks if a key is present and not null. * - * @param string|array $key + * @param string|array $key * @return bool * @static */ @@ -12942,8 +13025,8 @@ public static function has($key) /** * Get an item from the session. * - * @param string $key - * @param mixed $default + * @param string $key + * @param mixed $default * @return mixed * @static */ @@ -12956,8 +13039,8 @@ public static function get($key, $default = null) /** * Get the value of a given key and then forget it. * - * @param string $key - * @param mixed $default + * @param string $key + * @param mixed $default * @return mixed * @static */ @@ -12970,7 +13053,7 @@ public static function pull($key, $default = null) /** * Determine if the session contains old input. * - * @param string|null $key + * @param string|null $key * @return bool * @static */ @@ -12983,8 +13066,8 @@ public static function hasOldInput($key = null) /** * Get the requested item from the flashed input array. * - * @param string|null $key - * @param mixed $default + * @param string|null $key + * @param mixed $default * @return mixed * @static */ @@ -12997,7 +13080,7 @@ public static function getOldInput($key = null, $default = null) /** * Replace the given session attributes entirely. * - * @param array $attributes + * @param array $attributes * @return void * @static */ @@ -13010,8 +13093,8 @@ public static function replace($attributes) /** * Put a key / value pair or array of key / value pairs in the session. * - * @param string|array $key - * @param mixed $value + * @param string|array $key + * @param mixed $value * @return void * @static */ @@ -13024,8 +13107,8 @@ public static function put($key, $value = null) /** * Get an item from the session, or store the default value. * - * @param string $key - * @param \Closure $callback + * @param string $key + * @param \Closure $callback * @return mixed * @static */ @@ -13038,8 +13121,8 @@ public static function remember($key, $callback) /** * Push a value onto a session array. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value * @return void * @static */ @@ -13052,8 +13135,8 @@ public static function push($key, $value) /** * Increment the value of an item in the session. * - * @param string $key - * @param int $amount + * @param string $key + * @param int $amount * @return mixed * @static */ @@ -13066,8 +13149,8 @@ public static function increment($key, $amount = 1) /** * Decrement the value of an item in the session. * - * @param string $key - * @param int $amount + * @param string $key + * @param int $amount * @return int * @static */ @@ -13080,8 +13163,8 @@ public static function decrement($key, $amount = 1) /** * Flash a key / value pair to the session. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value * @return void * @static */ @@ -13094,8 +13177,8 @@ public static function flash($key, $value = true) /** * Flash a key / value pair to the session for immediate use. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value * @return void * @static */ @@ -13120,7 +13203,7 @@ public static function reflash() /** * Reflash a subset of the current flash data. * - * @param array|mixed $keys + * @param array|mixed $keys * @return void * @static */ @@ -13133,7 +13216,7 @@ public static function keep($keys = null) /** * Flash an input array to the session. * - * @param array $value + * @param array $value * @return void * @static */ @@ -13146,7 +13229,7 @@ public static function flashInput($value) /** * Remove an item from the session, returning its value. * - * @param string $key + * @param string $key * @return mixed * @static */ @@ -13159,7 +13242,7 @@ public static function remove($key) /** * Remove one or many items from the session. * - * @param string|array $keys + * @param string|array $keys * @return void * @static */ @@ -13196,7 +13279,7 @@ public static function invalidate() /** * Generate a new session identifier. * - * @param bool $destroy + * @param bool $destroy * @return bool * @static */ @@ -13209,7 +13292,7 @@ public static function regenerate($destroy = false) /** * Generate a new session ID for the session. * - * @param bool $destroy + * @param bool $destroy * @return bool * @static */ @@ -13246,7 +13329,7 @@ public static function getName() /** * Set the name of the session. * - * @param string $name + * @param string $name * @return void * @static */ @@ -13271,7 +13354,7 @@ public static function getId() /** * Set the session ID. * - * @param string $id + * @param string $id * @return void * @static */ @@ -13284,7 +13367,7 @@ public static function setId($id) /** * Determine if this is a valid session ID. * - * @param string $id + * @param string $id * @return bool * @static */ @@ -13297,7 +13380,7 @@ public static function isValidId($id) /** * Set the existence of the session on the handler if applicable. * - * @param bool $value + * @param bool $value * @return void * @static */ @@ -13346,7 +13429,7 @@ public static function previousUrl() /** * Set the "previous" URL in the session. * - * @param string $url + * @param string $url * @return void * @static */ @@ -13395,7 +13478,7 @@ public static function handlerNeedsRequest() /** * Set the request on the handler instance. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return void * @static */ @@ -13413,7 +13496,7 @@ class Storage /** * Get a filesystem instance. * - * @param string|null $name + * @param string|null $name * @return \Illuminate\Filesystem\FilesystemAdapter * @static */ @@ -13426,7 +13509,7 @@ public static function drive($name = null) /** * Get a filesystem instance. * - * @param string|null $name + * @param string|null $name * @return \Illuminate\Filesystem\FilesystemAdapter * @static */ @@ -13451,7 +13534,7 @@ public static function cloud() /** * Create an instance of the local driver. * - * @param array $config + * @param array $config * @return \Illuminate\Filesystem\FilesystemAdapter * @static */ @@ -13464,7 +13547,7 @@ public static function createLocalDriver($config) /** * Create an instance of the ftp driver. * - * @param array $config + * @param array $config * @return \Illuminate\Filesystem\FilesystemAdapter * @static */ @@ -13477,7 +13560,7 @@ public static function createFtpDriver($config) /** * Create an instance of the sftp driver. * - * @param array $config + * @param array $config * @return \Illuminate\Filesystem\FilesystemAdapter * @static */ @@ -13490,7 +13573,7 @@ public static function createSftpDriver($config) /** * Create an instance of the Amazon S3 driver. * - * @param array $config + * @param array $config * @return \Illuminate\Contracts\Filesystem\Cloud * @static */ @@ -13503,8 +13586,8 @@ public static function createS3Driver($config) /** * Set the given disk instance. * - * @param string $name - * @param mixed $disk + * @param string $name + * @param mixed $disk * @return \Illuminate\Filesystem\FilesystemManager * @static */ @@ -13541,7 +13624,7 @@ public static function getDefaultCloudDriver() /** * Unset the given disk instances. * - * @param array|string $disk + * @param array|string $disk * @return \Illuminate\Filesystem\FilesystemManager * @static */ @@ -13554,7 +13637,7 @@ public static function forgetDisk($disk) /** * Disconnect the given disk and remove from local cache. * - * @param string|null $name + * @param string|null $name * @return void * @static */ @@ -13567,8 +13650,8 @@ public static function purge($name = null) /** * Register a custom driver creator Closure. * - * @param string $driver - * @param \Closure $callback + * @param string $driver + * @param \Closure $callback * @return \Illuminate\Filesystem\FilesystemManager * @static */ @@ -13581,7 +13664,7 @@ public static function extend($driver, $callback) /** * Assert that the given file exists. * - * @param string|array $path + * @param string|array $path * @return \Illuminate\Filesystem\FilesystemAdapter * @static */ @@ -13594,7 +13677,7 @@ public static function assertExists($path) /** * Assert that the given file does not exist. * - * @param string|array $path + * @param string|array $path * @return \Illuminate\Filesystem\FilesystemAdapter * @static */ @@ -13607,7 +13690,7 @@ public static function assertMissing($path) /** * Determine if a file exists. * - * @param string $path + * @param string $path * @return bool * @static */ @@ -13620,7 +13703,7 @@ public static function exists($path) /** * Determine if a file or directory is missing. * - * @param string $path + * @param string $path * @return bool * @static */ @@ -13633,7 +13716,7 @@ public static function missing($path) /** * Get the full path for the file at the given "short" path. * - * @param string $path + * @param string $path * @return string * @static */ @@ -13646,8 +13729,9 @@ public static function path($path) /** * Get the contents of a file. * - * @param string $path + * @param string $path * @return string + * * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException * @static */ @@ -13660,10 +13744,10 @@ public static function get($path) /** * Create a streamed response for a given file. * - * @param string $path - * @param string|null $name - * @param array|null $headers - * @param string|null $disposition + * @param string $path + * @param string|null $name + * @param array|null $headers + * @param string|null $disposition * @return \Symfony\Component\HttpFoundation\StreamedResponse * @static */ @@ -13676,9 +13760,9 @@ public static function response($path, $name = null, $headers = [], $disposition /** * Create a streamed download response for a given file. * - * @param string $path - * @param string|null $name - * @param array|null $headers + * @param string $path + * @param string|null $name + * @param array|null $headers * @return \Symfony\Component\HttpFoundation\StreamedResponse * @static */ @@ -13691,9 +13775,9 @@ public static function download($path, $name = null, $headers = []) /** * Write the contents of a file. * - * @param string $path - * @param string|resource $contents - * @param mixed $options + * @param string $path + * @param string|resource $contents + * @param mixed $options * @return bool * @static */ @@ -13706,9 +13790,9 @@ public static function put($path, $contents, $options = []) /** * Store the uploaded file on the disk. * - * @param string $path - * @param \Illuminate\Http\File|\Illuminate\Http\UploadedFile|string $file - * @param mixed $options + * @param string $path + * @param \Illuminate\Http\File|\Illuminate\Http\UploadedFile|string $file + * @param mixed $options * @return string|false * @static */ @@ -13721,10 +13805,10 @@ public static function putFile($path, $file, $options = []) /** * Store the uploaded file on the disk with a given name. * - * @param string $path - * @param \Illuminate\Http\File|\Illuminate\Http\UploadedFile|string $file - * @param string $name - * @param mixed $options + * @param string $path + * @param \Illuminate\Http\File|\Illuminate\Http\UploadedFile|string $file + * @param string $name + * @param mixed $options * @return string|false * @static */ @@ -13737,7 +13821,7 @@ public static function putFileAs($path, $file, $name, $options = []) /** * Get the visibility for the given path. * - * @param string $path + * @param string $path * @return string * @static */ @@ -13750,8 +13834,8 @@ public static function getVisibility($path) /** * Set the visibility for the given path. * - * @param string $path - * @param string $visibility + * @param string $path + * @param string $visibility * @return bool * @static */ @@ -13764,9 +13848,9 @@ public static function setVisibility($path, $visibility) /** * Prepend to a file. * - * @param string $path - * @param string $data - * @param string $separator + * @param string $path + * @param string $data + * @param string $separator * @return bool * @static */ @@ -13780,9 +13864,9 @@ public static function prepend($path, $data, $separator = ' /** * Append to a file. * - * @param string $path - * @param string $data - * @param string $separator + * @param string $path + * @param string $data + * @param string $separator * @return bool * @static */ @@ -13796,7 +13880,7 @@ public static function append($path, $data, $separator = ' /** * Delete the file at a given path. * - * @param string|array $paths + * @param string|array $paths * @return bool * @static */ @@ -13809,8 +13893,8 @@ public static function delete($paths) /** * Copy a file to a new location. * - * @param string $from - * @param string $to + * @param string $from + * @param string $to * @return bool * @static */ @@ -13823,8 +13907,8 @@ public static function copy($from, $to) /** * Move a file to a new location. * - * @param string $from - * @param string $to + * @param string $from + * @param string $to * @return bool * @static */ @@ -13837,7 +13921,7 @@ public static function move($from, $to) /** * Get the file size of a given file. * - * @param string $path + * @param string $path * @return int * @static */ @@ -13850,7 +13934,7 @@ public static function size($path) /** * Get the mime-type of a given file. * - * @param string $path + * @param string $path * @return string|false * @static */ @@ -13863,7 +13947,7 @@ public static function mimeType($path) /** * Get the file's last modification time. * - * @param string $path + * @param string $path * @return int * @static */ @@ -13876,8 +13960,9 @@ public static function lastModified($path) /** * Get the URL for the file at the given path. * - * @param string $path + * @param string $path * @return string + * * @throws \RuntimeException * @static */ @@ -13890,8 +13975,9 @@ public static function url($path) /** * Get a resource to read the file. * - * @param string $path + * @param string $path * @return resource|null The path resource or null on failure. + * * @throws \Illuminate\Contracts\Filesystem\FileNotFoundException * @static */ @@ -13904,10 +13990,11 @@ public static function readStream($path) /** * Write a new file using a stream. * - * @param string $path - * @param resource $resource - * @param array $options + * @param string $path + * @param resource $resource + * @param array $options * @return bool + * * @throws \InvalidArgumentException If $resource is not a file handle. * @throws \Illuminate\Contracts\Filesystem\FileExistsException * @static @@ -13921,10 +14008,11 @@ public static function writeStream($path, $resource, $options = []) /** * Get a temporary URL for the file at the given path. * - * @param string $path - * @param \DateTimeInterface $expiration - * @param array $options + * @param string $path + * @param \DateTimeInterface $expiration + * @param array $options * @return string + * * @throws \RuntimeException * @static */ @@ -13937,10 +14025,10 @@ public static function temporaryUrl($path, $expiration, $options = []) /** * Get a temporary URL for the file at the given path. * - * @param \League\Flysystem\AwsS3v3\AwsS3Adapter $adapter - * @param string $path - * @param \DateTimeInterface $expiration - * @param array $options + * @param \League\Flysystem\AwsS3v3\AwsS3Adapter $adapter + * @param string $path + * @param \DateTimeInterface $expiration + * @param array $options * @return string * @static */ @@ -13953,8 +14041,8 @@ public static function getAwsTemporaryUrl($adapter, $path, $expiration, $options /** * Get an array of all files in a directory. * - * @param string|null $directory - * @param bool $recursive + * @param string|null $directory + * @param bool $recursive * @return array * @static */ @@ -13967,7 +14055,7 @@ public static function files($directory = null, $recursive = false) /** * Get all of the files from the given directory (recursive). * - * @param string|null $directory + * @param string|null $directory * @return array * @static */ @@ -13980,8 +14068,8 @@ public static function allFiles($directory = null) /** * Get all of the directories within a given directory. * - * @param string|null $directory - * @param bool $recursive + * @param string|null $directory + * @param bool $recursive * @return array * @static */ @@ -13994,7 +14082,7 @@ public static function directories($directory = null, $recursive = false) /** * Get all (recursive) of the directories within a given directory. * - * @param string|null $directory + * @param string|null $directory * @return array * @static */ @@ -14007,7 +14095,7 @@ public static function allDirectories($directory = null) /** * Create a directory. * - * @param string $path + * @param string $path * @return bool * @static */ @@ -14020,7 +14108,7 @@ public static function makeDirectory($path) /** * Recursively delete a directory. * - * @param string $directory + * @param string $directory * @return bool * @static */ @@ -14086,7 +14174,7 @@ public static function current() /** * Get the URL for the previous request. * - * @param mixed $fallback + * @param mixed $fallback * @return string * @static */ @@ -14099,9 +14187,9 @@ public static function previous($fallback = false) /** * Generate an absolute URL to the given path. * - * @param string $path - * @param mixed $extra - * @param bool|null $secure + * @param string $path + * @param mixed $extra + * @param bool|null $secure * @return string * @static */ @@ -14114,8 +14202,8 @@ public static function to($path, $extra = [], $secure = null) /** * Generate a secure, absolute URL to the given path. * - * @param string $path - * @param array $parameters + * @param string $path + * @param array $parameters * @return string * @static */ @@ -14128,8 +14216,8 @@ public static function secure($path, $parameters = []) /** * Generate the URL to an application asset. * - * @param string $path - * @param bool|null $secure + * @param string $path + * @param bool|null $secure * @return string * @static */ @@ -14142,7 +14230,7 @@ public static function asset($path, $secure = null) /** * Generate the URL to a secure asset. * - * @param string $path + * @param string $path * @return string * @static */ @@ -14155,9 +14243,9 @@ public static function secureAsset($path) /** * Generate the URL to an asset from a custom root domain such as CDN, etc. * - * @param string $root - * @param string $path - * @param bool|null $secure + * @param string $root + * @param string $path + * @param bool|null $secure * @return string * @static */ @@ -14170,7 +14258,7 @@ public static function assetFrom($root, $path, $secure = null) /** * Get the default scheme for a raw URL. * - * @param bool|null $secure + * @param bool|null $secure * @return string * @static */ @@ -14183,11 +14271,12 @@ public static function formatScheme($secure = null) /** * Create a signed route URL for a named route. * - * @param string $name - * @param mixed $parameters - * @param \DateTimeInterface|\DateInterval|int|null $expiration - * @param bool $absolute + * @param string $name + * @param mixed $parameters + * @param \DateTimeInterface|\DateInterval|int|null $expiration + * @param bool $absolute * @return string + * * @throws \InvalidArgumentException * @static */ @@ -14200,10 +14289,10 @@ public static function signedRoute($name, $parameters = [], $expiration = null, /** * Create a temporary signed route URL for a named route. * - * @param string $name - * @param \DateTimeInterface|\DateInterval|int $expiration - * @param array $parameters - * @param bool $absolute + * @param string $name + * @param \DateTimeInterface|\DateInterval|int $expiration + * @param array $parameters + * @param bool $absolute * @return string * @static */ @@ -14216,8 +14305,8 @@ public static function temporarySignedRoute($name, $expiration, $parameters = [] /** * Determine if the given request has a valid signature. * - * @param \Illuminate\Http\Request $request - * @param bool $absolute + * @param \Illuminate\Http\Request $request + * @param bool $absolute * @return bool * @static */ @@ -14230,7 +14319,7 @@ public static function hasValidSignature($request, $absolute = true) /** * Determine if the given request has a valid signature for a relative URL. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return bool * @static */ @@ -14243,8 +14332,8 @@ public static function hasValidRelativeSignature($request) /** * Determine if the signature from the given request matches the URL. * - * @param \Illuminate\Http\Request $request - * @param bool $absolute + * @param \Illuminate\Http\Request $request + * @param bool $absolute * @return bool * @static */ @@ -14257,7 +14346,7 @@ public static function hasCorrectSignature($request, $absolute = true) /** * Determine if the expires timestamp from the given request is not from the past. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return bool * @static */ @@ -14270,10 +14359,11 @@ public static function signatureHasNotExpired($request) /** * Get the URL to a named route. * - * @param string $name - * @param mixed $parameters - * @param bool $absolute + * @param string $name + * @param mixed $parameters + * @param bool $absolute * @return string + * * @throws \Symfony\Component\Routing\Exception\RouteNotFoundException * @static */ @@ -14286,10 +14376,11 @@ public static function route($name, $parameters = [], $absolute = true) /** * Get the URL for a given route instance. * - * @param \Illuminate\Routing\Route $route - * @param mixed $parameters - * @param bool $absolute + * @param \Illuminate\Routing\Route $route + * @param mixed $parameters + * @param bool $absolute * @return string + * * @throws \Illuminate\Routing\Exceptions\UrlGenerationException * @static */ @@ -14302,10 +14393,11 @@ public static function toRoute($route, $parameters, $absolute) /** * Get the URL to a controller action. * - * @param string|array $action - * @param mixed $parameters - * @param bool $absolute + * @param string|array $action + * @param mixed $parameters + * @param bool $absolute * @return string + * * @throws \InvalidArgumentException * @static */ @@ -14318,7 +14410,7 @@ public static function action($action, $parameters = [], $absolute = true) /** * Format the array of URL parameters. * - * @param mixed|array $parameters + * @param mixed|array $parameters * @return array * @static */ @@ -14331,8 +14423,8 @@ public static function formatParameters($parameters) /** * Get the base URL for the request. * - * @param string $scheme - * @param string|null $root + * @param string $scheme + * @param string|null $root * @return string * @static */ @@ -14345,9 +14437,9 @@ public static function formatRoot($scheme, $root = null) /** * Format the given URL segments into a single URL. * - * @param string $root - * @param string $path - * @param \Illuminate\Routing\Route|null $route + * @param string $root + * @param string $path + * @param \Illuminate\Routing\Route|null $route * @return string * @static */ @@ -14360,7 +14452,7 @@ public static function format($root, $path, $route = null) /** * Determine if the given path is a valid URL. * - * @param string $path + * @param string $path * @return bool * @static */ @@ -14373,7 +14465,7 @@ public static function isValidUrl($path) /** * Set the default named parameters used by the URL generator. * - * @param array $defaults + * @param array $defaults * @return void * @static */ @@ -14398,7 +14490,7 @@ public static function getDefaultParameters() /** * Force the scheme for URLs. * - * @param string|null $scheme + * @param string|null $scheme * @return void * @static */ @@ -14411,7 +14503,7 @@ public static function forceScheme($scheme) /** * Set the forced root URL. * - * @param string|null $root + * @param string|null $root * @return void * @static */ @@ -14424,7 +14516,7 @@ public static function forceRootUrl($root) /** * Set a callback to be used to format the host of generated URLs. * - * @param \Closure $callback + * @param \Closure $callback * @return \Illuminate\Routing\UrlGenerator * @static */ @@ -14437,7 +14529,7 @@ public static function formatHostUsing($callback) /** * Set a callback to be used to format the path of generated URLs. * - * @param \Closure $callback + * @param \Closure $callback * @return \Illuminate\Routing\UrlGenerator * @static */ @@ -14474,7 +14566,7 @@ public static function getRequest() /** * Set the current request instance. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return void * @static */ @@ -14487,7 +14579,7 @@ public static function setRequest($request) /** * Set the route collection. * - * @param \Illuminate\Routing\RouteCollectionInterface $routes + * @param \Illuminate\Routing\RouteCollectionInterface $routes * @return \Illuminate\Routing\UrlGenerator * @static */ @@ -14500,7 +14592,7 @@ public static function setRoutes($routes) /** * Set the session resolver for the generator. * - * @param callable $sessionResolver + * @param callable $sessionResolver * @return \Illuminate\Routing\UrlGenerator * @static */ @@ -14513,7 +14605,7 @@ public static function setSessionResolver($sessionResolver) /** * Set the encryption key resolver. * - * @param callable $keyResolver + * @param callable $keyResolver * @return \Illuminate\Routing\UrlGenerator * @static */ @@ -14526,7 +14618,7 @@ public static function setKeyResolver($keyResolver) /** * Set the root controller namespace. * - * @param string $rootNamespace + * @param string $rootNamespace * @return \Illuminate\Routing\UrlGenerator * @static */ @@ -14539,8 +14631,8 @@ public static function setRootControllerNamespace($rootNamespace) /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -14552,9 +14644,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -14566,7 +14659,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -14583,10 +14676,10 @@ class Validator /** * Create a new Validator instance. * - * @param array $data - * @param array $rules - * @param array $messages - * @param array $customAttributes + * @param array $data + * @param array $rules + * @param array $messages + * @param array $customAttributes * @return \Illuminate\Validation\Validator * @static */ @@ -14599,11 +14692,12 @@ public static function make($data, $rules, $messages = [], $customAttributes = [ /** * Validate the given data against the provided rules. * - * @param array $data - * @param array $rules - * @param array $messages - * @param array $customAttributes + * @param array $data + * @param array $rules + * @param array $messages + * @param array $customAttributes * @return array + * * @throws \Illuminate\Validation\ValidationException * @static */ @@ -14616,9 +14710,9 @@ public static function validate($data, $rules, $messages = [], $customAttributes /** * Register a custom validator extension. * - * @param string $rule - * @param \Closure|string $extension - * @param string|null $message + * @param string $rule + * @param \Closure|string $extension + * @param string|null $message * @return void * @static */ @@ -14631,9 +14725,9 @@ public static function extend($rule, $extension, $message = null) /** * Register a custom implicit validator extension. * - * @param string $rule - * @param \Closure|string $extension - * @param string|null $message + * @param string $rule + * @param \Closure|string $extension + * @param string|null $message * @return void * @static */ @@ -14646,9 +14740,9 @@ public static function extendImplicit($rule, $extension, $message = null) /** * Register a custom dependent validator extension. * - * @param string $rule - * @param \Closure|string $extension - * @param string|null $message + * @param string $rule + * @param \Closure|string $extension + * @param string|null $message * @return void * @static */ @@ -14661,8 +14755,8 @@ public static function extendDependent($rule, $extension, $message = null) /** * Register a custom validator message replacer. * - * @param string $rule - * @param \Closure|string $replacer + * @param string $rule + * @param \Closure|string $replacer * @return void * @static */ @@ -14675,7 +14769,7 @@ public static function replacer($rule, $replacer) /** * Set the Validator instance resolver. * - * @param \Closure $resolver + * @param \Closure $resolver * @return void * @static */ @@ -14712,7 +14806,7 @@ public static function getPresenceVerifier() /** * Set the Presence Verifier implementation. * - * @param \Illuminate\Validation\PresenceVerifierInterface $presenceVerifier + * @param \Illuminate\Validation\PresenceVerifierInterface $presenceVerifier * @return void * @static */ @@ -14730,9 +14824,9 @@ class View /** * Get the evaluated view contents for the given view. * - * @param string $path - * @param \Illuminate\Contracts\Support\Arrayable|array $data - * @param array $mergeData + * @param string $path + * @param \Illuminate\Contracts\Support\Arrayable|array $data + * @param array $mergeData * @return \Illuminate\Contracts\View\View * @static */ @@ -14745,9 +14839,9 @@ public static function file($path, $data = [], $mergeData = []) /** * Get the evaluated view contents for the given view. * - * @param string $view - * @param \Illuminate\Contracts\Support\Arrayable|array $data - * @param array $mergeData + * @param string $view + * @param \Illuminate\Contracts\Support\Arrayable|array $data + * @param array $mergeData * @return \Illuminate\Contracts\View\View * @static */ @@ -14760,10 +14854,11 @@ public static function make($view, $data = [], $mergeData = []) /** * Get the first view that actually exists from the given list. * - * @param array $views - * @param \Illuminate\Contracts\Support\Arrayable|array $data - * @param array $mergeData + * @param array $views + * @param \Illuminate\Contracts\Support\Arrayable|array $data + * @param array $mergeData * @return \Illuminate\Contracts\View\View + * * @throws \InvalidArgumentException * @static */ @@ -14776,10 +14871,10 @@ public static function first($views, $data = [], $mergeData = []) /** * Get the rendered content of the view based on a given condition. * - * @param bool $condition - * @param string $view - * @param \Illuminate\Contracts\Support\Arrayable|array $data - * @param array $mergeData + * @param bool $condition + * @param string $view + * @param \Illuminate\Contracts\Support\Arrayable|array $data + * @param array $mergeData * @return string * @static */ @@ -14792,10 +14887,10 @@ public static function renderWhen($condition, $view, $data = [], $mergeData = [] /** * Get the rendered contents of a partial from a loop. * - * @param string $view - * @param array $data - * @param string $iterator - * @param string $empty + * @param string $view + * @param array $data + * @param string $iterator + * @param string $empty * @return string * @static */ @@ -14808,7 +14903,7 @@ public static function renderEach($view, $data, $iterator, $empty = 'raw|') /** * Determine if a given view exists. * - * @param string $view + * @param string $view * @return bool * @static */ @@ -14821,8 +14916,9 @@ public static function exists($view) /** * Get the appropriate view engine for the given path. * - * @param string $path + * @param string $path * @return \Illuminate\Contracts\View\Engine + * * @throws \InvalidArgumentException * @static */ @@ -14835,8 +14931,8 @@ public static function getEngineFromPath($path) /** * Add a piece of shared data to the environment. * - * @param array|string $key - * @param mixed|null $value + * @param array|string $key + * @param mixed|null $value * @return mixed * @static */ @@ -14885,7 +14981,7 @@ public static function doneRendering() /** * Determine if the given once token has been rendered. * - * @param string $id + * @param string $id * @return bool * @static */ @@ -14898,7 +14994,7 @@ public static function hasRenderedOnce($id) /** * Mark the given once token as having been rendered. * - * @param string $id + * @param string $id * @return void * @static */ @@ -14911,7 +15007,7 @@ public static function markAsRenderedOnce($id) /** * Add a location to the array of view locations. * - * @param string $location + * @param string $location * @return void * @static */ @@ -14924,8 +15020,8 @@ public static function addLocation($location) /** * Add a new namespace to the loader. * - * @param string $namespace - * @param string|array $hints + * @param string $namespace + * @param string|array $hints * @return \Illuminate\View\Factory * @static */ @@ -14938,8 +15034,8 @@ public static function addNamespace($namespace, $hints) /** * Prepend a new namespace to the loader. * - * @param string $namespace - * @param string|array $hints + * @param string $namespace + * @param string|array $hints * @return \Illuminate\View\Factory * @static */ @@ -14952,8 +15048,8 @@ public static function prependNamespace($namespace, $hints) /** * Replace the namespace hints for the given namespace. * - * @param string $namespace - * @param string|array $hints + * @param string $namespace + * @param string|array $hints * @return \Illuminate\View\Factory * @static */ @@ -14966,9 +15062,9 @@ public static function replaceNamespace($namespace, $hints) /** * Register a valid view extension and its engine. * - * @param string $extension - * @param string $engine - * @param \Closure|null $resolver + * @param string $extension + * @param string $engine + * @param \Closure|null $resolver * @return void * @static */ @@ -15041,7 +15137,7 @@ public static function getFinder() /** * Set the view finder instance. * - * @param \Illuminate\View\ViewFinderInterface $finder + * @param \Illuminate\View\ViewFinderInterface $finder * @return void * @static */ @@ -15078,7 +15174,7 @@ public static function getDispatcher() /** * Set the event dispatcher instance. * - * @param \Illuminate\Contracts\Events\Dispatcher $events + * @param \Illuminate\Contracts\Events\Dispatcher $events * @return void * @static */ @@ -15103,7 +15199,7 @@ public static function getContainer() /** * Set the IoC container instance. * - * @param \Illuminate\Contracts\Container\Container $container + * @param \Illuminate\Contracts\Container\Container $container * @return void * @static */ @@ -15116,8 +15212,8 @@ public static function setContainer($container) /** * Get an item from the shared data. * - * @param string $key - * @param mixed $default + * @param string $key + * @param mixed $default * @return mixed * @static */ @@ -15142,8 +15238,8 @@ public static function getShared() /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -15155,9 +15251,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -15169,7 +15266,7 @@ public static function mixin($mixin, $replace = true) /** * Checks if macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -15181,8 +15278,8 @@ public static function hasMacro($name) /** * Start a component rendering process. * - * @param \Illuminate\Contracts\View\View|\Illuminate\Contracts\Support\Htmlable|\Closure|string $view - * @param array $data + * @param \Illuminate\Contracts\View\View|\Illuminate\Contracts\Support\Htmlable|\Closure|string $view + * @param array $data * @return void * @static */ @@ -15195,8 +15292,8 @@ public static function startComponent($view, $data = []) /** * Get the first view that actually exists from the given list, and start a component. * - * @param array $names - * @param array $data + * @param array $names + * @param array $data * @return void * @static */ @@ -15221,8 +15318,8 @@ public static function renderComponent() /** * Start the slot rendering process. * - * @param string $name - * @param string|null $content + * @param string $name + * @param string|null $content * @return void * @static */ @@ -15247,8 +15344,8 @@ public static function endSlot() /** * Register a view creator event. * - * @param array|string $views - * @param \Closure|string $callback + * @param array|string $views + * @param \Closure|string $callback * @return array * @static */ @@ -15261,7 +15358,7 @@ public static function creator($views, $callback) /** * Register multiple view composers via an array. * - * @param array $composers + * @param array $composers * @return array * @static */ @@ -15274,8 +15371,8 @@ public static function composers($composers) /** * Register a view composer event. * - * @param array|string $views - * @param \Closure|string $callback + * @param array|string $views + * @param \Closure|string $callback * @return array * @static */ @@ -15288,7 +15385,7 @@ public static function composer($views, $callback) /** * Call the composer for a given view. * - * @param \Illuminate\Contracts\View\View $view + * @param \Illuminate\Contracts\View\View $view * @return void * @static */ @@ -15301,7 +15398,7 @@ public static function callComposer($view) /** * Call the creator for a given view. * - * @param \Illuminate\Contracts\View\View $view + * @param \Illuminate\Contracts\View\View $view * @return void * @static */ @@ -15314,8 +15411,8 @@ public static function callCreator($view) /** * Start injecting content into a section. * - * @param string $section - * @param string|null $content + * @param string $section + * @param string|null $content * @return void * @static */ @@ -15328,8 +15425,8 @@ public static function startSection($section, $content = null) /** * Inject inline content into a section. * - * @param string $section - * @param string $content + * @param string $section + * @param string $content * @return void * @static */ @@ -15354,8 +15451,9 @@ public static function yieldSection() /** * Stop injecting content into a section. * - * @param bool $overwrite + * @param bool $overwrite * @return string + * * @throws \InvalidArgumentException * @static */ @@ -15369,6 +15467,7 @@ public static function stopSection($overwrite = false) * Stop injecting content into a section and append it. * * @return string + * * @throws \InvalidArgumentException * @static */ @@ -15381,8 +15480,8 @@ public static function appendSection() /** * Get the string contents of a section. * - * @param string $section - * @param string $default + * @param string $section + * @param string $default * @return string * @static */ @@ -15395,7 +15494,7 @@ public static function yieldContent($section, $default = '') /** * Get the parent placeholder for the current request. * - * @param string $section + * @param string $section * @return string * @static */ @@ -15407,7 +15506,7 @@ public static function parentPlaceholder($section = '') /** * Check if section exists. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -15420,7 +15519,7 @@ public static function hasSection($name) /** * Check if section does not exist. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -15433,8 +15532,8 @@ public static function sectionMissing($name) /** * Get the contents of a section. * - * @param string $name - * @param string|null $default + * @param string $name + * @param string|null $default * @return mixed * @static */ @@ -15471,7 +15570,7 @@ public static function flushSections() /** * Add new loop to the stack. * - * @param \Countable|array $data + * @param \Countable|array $data * @return void * @static */ @@ -15532,8 +15631,8 @@ public static function getLoopStack() /** * Start injecting content into a push section. * - * @param string $section - * @param string $content + * @param string $section + * @param string $content * @return void * @static */ @@ -15547,6 +15646,7 @@ public static function startPush($section, $content = '') * Stop injecting content into a push section. * * @return string + * * @throws \InvalidArgumentException * @static */ @@ -15559,8 +15659,8 @@ public static function stopPush() /** * Start prepending content into a push section. * - * @param string $section - * @param string $content + * @param string $section + * @param string $content * @return void * @static */ @@ -15574,6 +15674,7 @@ public static function startPrepend($section, $content = '') * Stop prepending content into a push section. * * @return string + * * @throws \InvalidArgumentException * @static */ @@ -15586,8 +15687,8 @@ public static function stopPrepend() /** * Get the string contents of a push section. * - * @param string $section - * @param string $default + * @param string $section + * @param string $default * @return string * @static */ @@ -15612,7 +15713,7 @@ public static function flushStacks() /** * Start a translation block. * - * @param array $replacements + * @param array $replacements * @return void * @static */ @@ -15652,7 +15753,7 @@ class Image /** * Overrides configuration settings. * - * @param array $config + * @param array $config * @return self * @static */ @@ -15665,7 +15766,7 @@ public static function configure($config = []) /** * Initiates an Image instance from different input types. * - * @param mixed $data + * @param mixed $data * @return \Intervention\Image\Image * @static */ @@ -15678,9 +15779,9 @@ public static function make($data) /** * Creates an empty image canvas. * - * @param int $width - * @param int $height - * @param mixed $background + * @param int $width + * @param int $height + * @param mixed $background * @return \Intervention\Image\Image * @static */ @@ -15694,9 +15795,9 @@ public static function canvas($width, $height, $background = null) * Create new cached image and run callback * (requires additional package intervention/imagecache). * - * @param \Closure $callback - * @param int $lifetime - * @param bool $returnObj + * @param \Closure $callback + * @param int $lifetime + * @param bool $returnObj * @return \Image * @static */ @@ -15716,10 +15817,10 @@ class BatchFacade /** * Update multiple rows. * - * @param \Mavinoo\Batch\Model $table - * @param array $values - * @param string $index - * @param bool $raw + * @param \Mavinoo\Batch\Model $table + * @param array $values + * @param string $index + * @param bool $raw * @return bool|int * @updatedBy Ibrahim Sakr * @desc Example @@ -15748,11 +15849,11 @@ public static function update($table, $values, $index = null, $raw = false) /** * Update multiple rows. * - * @param \Mavinoo\Batch\Model $table - * @param array $values - * @param string $index - * @param string|null $index2 - * @param bool $raw + * @param \Mavinoo\Batch\Model $table + * @param array $values + * @param string $index + * @param string|null $index2 + * @param bool $raw * @return bool|int * @updatedBy Ibrahim Sakr * @desc Example @@ -15782,12 +15883,13 @@ public static function updateWithTwoIndex($table, $values, $index = null, $index /** * Insert Multi rows. * - * @param \Mavinoo\Batch\Model $table - * @param array $columns - * @param array $values - * @param int $batchSize - * @param bool $insertIgnore + * @param \Mavinoo\Batch\Model $table + * @param array $columns + * @param array $values + * @param int $batchSize + * @param bool $insertIgnore * @return bool|mixed + * * @throws \Throwable * @updatedBy Ibrahim Sakr * @desc Example @@ -16130,7 +16232,7 @@ public static function getProperties() /** * Get accept languages. * - * @param string $acceptLanguage + * @param string $acceptLanguage * @return array * @static */ @@ -16143,7 +16245,7 @@ public static function languages($acceptLanguage = null) /** * Get the browser name. * - * @param string|null $userAgent + * @param string|null $userAgent * @return string|bool * @static */ @@ -16156,7 +16258,7 @@ public static function browser($userAgent = null) /** * Get the platform name. * - * @param string|null $userAgent + * @param string|null $userAgent * @return string|bool * @static */ @@ -16169,7 +16271,7 @@ public static function platform($userAgent = null) /** * Get the device name. * - * @param string|null $userAgent + * @param string|null $userAgent * @return string|bool * @static */ @@ -16182,8 +16284,8 @@ public static function device($userAgent = null) /** * Check if the device is a desktop computer. * - * @param string|null $userAgent deprecated - * @param array $httpHeaders deprecated + * @param string|null $userAgent deprecated + * @param array $httpHeaders deprecated * @return bool * @static */ @@ -16196,8 +16298,8 @@ public static function isDesktop($userAgent = null, $httpHeaders = null) /** * Check if the device is a mobile phone. * - * @param string|null $userAgent deprecated - * @param array $httpHeaders deprecated + * @param string|null $userAgent deprecated + * @param array $httpHeaders deprecated * @return bool * @static */ @@ -16210,7 +16312,7 @@ public static function isPhone($userAgent = null, $httpHeaders = null) /** * Get the robot name. * - * @param string|null $userAgent + * @param string|null $userAgent * @return string|bool * @static */ @@ -16223,7 +16325,7 @@ public static function robot($userAgent = null) /** * Check if device is a robot. * - * @param string|null $userAgent + * @param string|null $userAgent * @return bool * @static */ @@ -16236,8 +16338,8 @@ public static function isRobot($userAgent = null) /** * Get the device type. * - * @param null $userAgent - * @param null $httpHeaders + * @param null $userAgent + * @param null $httpHeaders * @return string * @static */ @@ -16274,8 +16376,8 @@ public static function getScriptVersion() /** * Set the HTTP Headers. Must be PHP-flavored. This method will reset existing headers. * - * @param array $httpHeaders The headers to set. If null, then using PHP's _SERVER to extract - * the headers. The default null is left for backwards compatibility. + * @param array $httpHeaders The headers to set. If null, then using PHP's _SERVER to extract + * the headers. The default null is left for backwards compatibility. * @static */ public static function setHttpHeaders($httpHeaders = null) @@ -16301,9 +16403,9 @@ public static function getHttpHeaders() * * Simply null is returned. * - * @param string $header The name of the header to retrieve. Can be HTTP compliant such as - * "User-Agent" or "X-Device-User-Agent" or can be php-esque with the - * all-caps, HTTP_ prefixed, underscore seperated awesomeness. + * @param string $header The name of the header to retrieve. Can be HTTP compliant such as + * "User-Agent" or "X-Device-User-Agent" or can be php-esque with the + * all-caps, HTTP_ prefixed, underscore seperated awesomeness. * @return string|null The value of the header. * @static */ @@ -16339,7 +16441,7 @@ public static function getUaHttpHeaders() * Set CloudFront headers * http://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/header-caching.html#header-caching-web-device. * - * @param array $cfHeaders List of HTTP headers + * @param array $cfHeaders List of HTTP headers * @return bool If there were CloudFront headers to be set * @static */ @@ -16364,7 +16466,7 @@ public static function getCfHeaders() /** * Set the User-Agent to be used. * - * @param string $userAgent The user agent string to set. + * @param string $userAgent The user agent string to set. * @return string|null * @static */ @@ -16391,8 +16493,9 @@ public static function getUserAgent() * self::DETECTION_TYPE_EXTENDED. Otherwise, nothing is set. * * @deprecated since version 2.6.9 - * @param string $type The type. Must be a self::DETECTION_TYPE_* constant. The default - * parameter is null which will default to self::DETECTION_TYPE_MOBILE. + * + * @param string $type The type. Must be a self::DETECTION_TYPE_* constant. The default + * parameter is null which will default to self::DETECTION_TYPE_MOBILE. * @static */ public static function setDetectionType($type = null) @@ -16467,6 +16570,7 @@ public static function getUtilities() * Method gets the mobile detection rules. This method is used for the magic methods $detect->is*(). * * @deprecated since version 2.6.9 + * * @return array All the rules (but not extended). * @static */ @@ -16483,6 +16587,7 @@ public static function getMobileDetectionRules() * the new $detect->is('stuff') method. * * @deprecated since version 2.6.9 + * * @return array All the rules + extended. * @static */ @@ -16512,8 +16617,8 @@ public static function checkHttpHeadersForMobile() * * Returns true if any type of mobile device detected, including special ones * - * @param null $userAgent deprecated - * @param null $httpHeaders deprecated + * @param null $userAgent deprecated + * @param null $httpHeaders deprecated * @return bool * @static */ @@ -16528,8 +16633,8 @@ public static function isMobile($userAgent = null, $httpHeaders = null) * * Return true if any type of tablet device is detected. * - * @param string $userAgent deprecated - * @param array $httpHeaders deprecated + * @param string $userAgent deprecated + * @param array $httpHeaders deprecated * @return bool * @static */ @@ -16544,9 +16649,10 @@ public static function isTablet($userAgent = null, $httpHeaders = null) * userAgent. * * @todo : The httpHeaders part is not yet used. - * @param string $key - * @param string $userAgent deprecated - * @param string $httpHeaders deprecated + * + * @param string $key + * @param string $userAgent deprecated + * @param string $httpHeaders deprecated * @return bool|int|null * @static */ @@ -16566,8 +16672,9 @@ public static function is($key, $userAgent = null, $httpHeaders = null) * the User-Agent string. * * @param $regex - * @param string $userAgent + * @param string $userAgent * @return bool + * * @todo : search in the HTTP headers too. * @static */ @@ -16581,7 +16688,8 @@ public static function match($regex, $userAgent = null) * Prepare the version number. * * @todo Remove the error supression from str_replace() call. - * @param string $ver The string version, like "2.6.21.2152"; + * + * @param string $ver The string version, like "2.6.21.2152"; * @return float * @static */ @@ -16613,7 +16721,7 @@ class JWTAuth /** * Attempt to authenticate the user and return the token. * - * @param array $credentials + * @param array $credentials * @return false|string * @static */ @@ -16662,7 +16770,7 @@ public static function user() /** * Generate a token for a given subject. * - * @param \Tymon\JWTAuth\Contracts\JWTSubject $subject + * @param \Tymon\JWTAuth\Contracts\JWTSubject $subject * @return string * @static */ @@ -16675,7 +16783,7 @@ public static function fromSubject($subject) /** * Alias to generate a token for a given user. * - * @param \Tymon\JWTAuth\Contracts\JWTSubject $user + * @param \Tymon\JWTAuth\Contracts\JWTSubject $user * @return string * @static */ @@ -16688,8 +16796,8 @@ public static function fromUser($user) /** * Refresh an expired token. * - * @param bool $forceForever - * @param bool $resetClaims + * @param bool $forceForever + * @param bool $resetClaims * @return string * @static */ @@ -16702,7 +16810,7 @@ public static function refresh($forceForever = false, $resetClaims = false) /** * Invalidate a token (add it to the blacklist). * - * @param bool $forceForever + * @param bool $forceForever * @return \Tymon\JWTAuth\JWTAuth * @static */ @@ -16716,8 +16824,9 @@ public static function invalidate($forceForever = false) * Alias to get the payload, and as a result checks that * the token is valid i.e. not expired or blacklisted. * - * @throws \Tymon\JWTAuth\Exceptions\JWTException * @return \Tymon\JWTAuth\Payload + * + * @throws \Tymon\JWTAuth\Exceptions\JWTException * @static */ public static function checkOrFail() @@ -16729,7 +16838,7 @@ public static function checkOrFail() /** * Check that the token is valid. * - * @param bool $getPayload + * @param bool $getPayload * @return \Tymon\JWTAuth\Payload|bool * @static */ @@ -16754,8 +16863,9 @@ public static function getToken() /** * Parse the token from the request. * - * @throws \Tymon\JWTAuth\Exceptions\JWTException * @return \Tymon\JWTAuth\JWTAuth + * + * @throws \Tymon\JWTAuth\Exceptions\JWTException * @static */ public static function parseToken() @@ -16791,7 +16901,7 @@ public static function payload() /** * Convenience method to get a claim value. * - * @param string $claim + * @param string $claim * @return mixed * @static */ @@ -16804,7 +16914,7 @@ public static function getClaim($claim) /** * Create a Payload instance. * - * @param \Tymon\JWTAuth\Contracts\JWTSubject $subject + * @param \Tymon\JWTAuth\Contracts\JWTSubject $subject * @return \Tymon\JWTAuth\Payload * @static */ @@ -16817,7 +16927,7 @@ public static function makePayload($subject) /** * Check if the subject model matches the one saved in the token. * - * @param string|object $model + * @param string|object $model * @return bool * @static */ @@ -16830,7 +16940,7 @@ public static function checkSubjectModel($model) /** * Set the token. * - * @param \Tymon\JWTAuth\Token|string $token + * @param \Tymon\JWTAuth\Token|string $token * @return \Tymon\JWTAuth\JWTAuth * @static */ @@ -16855,7 +16965,7 @@ public static function unsetToken() /** * Set the request instance. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return \Tymon\JWTAuth\JWTAuth * @static */ @@ -16868,7 +16978,7 @@ public static function setRequest($request) /** * Set whether the subject should be "locked". * - * @param bool $lock + * @param bool $lock * @return \Tymon\JWTAuth\JWTAuth * @static */ @@ -16929,7 +17039,7 @@ public static function blacklist() /** * Set the custom claims. * - * @param array $customClaims + * @param array $customClaims * @return \Tymon\JWTAuth\JWTAuth * @static */ @@ -16942,7 +17052,7 @@ public static function customClaims($customClaims) /** * Alias to set the custom claims. * - * @param array $customClaims + * @param array $customClaims * @return \Tymon\JWTAuth\JWTAuth * @static */ @@ -16970,7 +17080,7 @@ class JWTFactory /** * Create the Payload instance. * - * @param bool $resetClaims + * @param bool $resetClaims * @return \Tymon\JWTAuth\Payload * @static */ @@ -17007,7 +17117,7 @@ public static function buildClaimsCollection() /** * Get a Payload instance with a claims collection. * - * @param \Tymon\JWTAuth\Claims\Collection $claims + * @param \Tymon\JWTAuth\Claims\Collection $claims * @return \Tymon\JWTAuth\Payload * @static */ @@ -17020,7 +17130,7 @@ public static function withClaims($claims) /** * Set the default claims to be added to the Payload. * - * @param array $claims + * @param array $claims * @return \Tymon\JWTAuth\Factory * @static */ @@ -17033,7 +17143,7 @@ public static function setDefaultClaims($claims) /** * Helper to set the ttl. * - * @param int $ttl + * @param int $ttl * @return \Tymon\JWTAuth\Factory * @static */ @@ -17082,7 +17192,7 @@ public static function validator() /** * Set the custom claims. * - * @param array $customClaims + * @param array $customClaims * @return \Tymon\JWTAuth\Factory * @static */ @@ -17095,7 +17205,7 @@ public static function customClaims($customClaims) /** * Alias to set the custom claims. * - * @param array $customClaims + * @param array $customClaims * @return \Tymon\JWTAuth\Factory * @static */ @@ -17120,7 +17230,7 @@ public static function getCustomClaims() /** * Set the refresh flow flag. * - * @param bool $refreshFlow + * @param bool $refreshFlow * @return \Tymon\JWTAuth\Factory * @static */ @@ -17138,8 +17248,8 @@ public static function setRefreshFlow($refreshFlow = true) class Request { /** - * @param array $rules - * @param mixed $params + * @param array $rules + * @param mixed $params * @static */ public static function validate($rules, ...$params) @@ -17148,9 +17258,9 @@ public static function validate($rules, ...$params) } /** - * @param string $errorBag - * @param array $rules - * @param mixed $params + * @param string $errorBag + * @param array $rules + * @param mixed $params * @static */ public static function validateWithBag($errorBag, $rules, ...$params) @@ -17159,7 +17269,7 @@ public static function validateWithBag($errorBag, $rules, ...$params) } /** - * @param mixed $absolute + * @param mixed $absolute * @static */ public static function hasValidSignature($absolute = true) @@ -17185,7 +17295,7 @@ public static function hasValidRelativeSignature() class Router { /** - * @param mixed $options + * @param mixed $options * @static */ public static function auth($options = []) @@ -17262,7 +17372,7 @@ class Eloquent extends \Illuminate\Database\Eloquent\Model /** * Create and return an un-saved model instance. * - * @param array $attributes + * @param array $attributes * @return \Illuminate\Database\Eloquent\Model|static * @static */ @@ -17275,8 +17385,8 @@ public static function make($attributes = []) /** * Register a new global scope. * - * @param string $identifier - * @param \Illuminate\Database\Eloquent\Scope|\Closure $scope + * @param string $identifier + * @param \Illuminate\Database\Eloquent\Scope|\Closure $scope * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17289,7 +17399,7 @@ public static function withGlobalScope($identifier, $scope) /** * Remove a registered global scope. * - * @param \Illuminate\Database\Eloquent\Scope|string $scope + * @param \Illuminate\Database\Eloquent\Scope|string $scope * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17302,7 +17412,7 @@ public static function withoutGlobalScope($scope) /** * Remove all or passed registered global scopes. * - * @param array|null $scopes + * @param array|null $scopes * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17327,7 +17437,7 @@ public static function removedScopes() /** * Add a where clause on the primary key to the query. * - * @param mixed $id + * @param mixed $id * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17340,7 +17450,7 @@ public static function whereKey($id) /** * Add a where clause on the primary key to the query. * - * @param mixed $id + * @param mixed $id * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17353,10 +17463,10 @@ public static function whereKeyNot($id) /** * Add a basic where clause to the query. * - * @param \Closure|string|array|\Illuminate\Database\Query\Expression $column - * @param mixed $operator - * @param mixed $value - * @param string $boolean + * @param \Closure|string|array|\Illuminate\Database\Query\Expression $column + * @param mixed $operator + * @param mixed $value + * @param string $boolean * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17369,10 +17479,10 @@ public static function where($column, $operator = null, $value = null, $boolean /** * Add a basic where clause to the query, and return the first result. * - * @param \Closure|string|array|\Illuminate\Database\Query\Expression $column - * @param mixed $operator - * @param mixed $value - * @param string $boolean + * @param \Closure|string|array|\Illuminate\Database\Query\Expression $column + * @param mixed $operator + * @param mixed $value + * @param string $boolean * @return \Illuminate\Database\Eloquent\Model|static * @static */ @@ -17385,9 +17495,9 @@ public static function firstWhere($column, $operator = null, $value = null, $boo /** * Add an "or where" clause to the query. * - * @param \Closure|array|string|\Illuminate\Database\Query\Expression $column - * @param mixed $operator - * @param mixed $value + * @param \Closure|array|string|\Illuminate\Database\Query\Expression $column + * @param mixed $operator + * @param mixed $value * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17400,7 +17510,7 @@ public static function orWhere($column, $operator = null, $value = null) /** * Add an "order by" clause for a timestamp to the query. * - * @param string|\Illuminate\Database\Query\Expression $column + * @param string|\Illuminate\Database\Query\Expression $column * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17413,7 +17523,7 @@ public static function latest($column = null) /** * Add an "order by" clause for a timestamp to the query. * - * @param string|\Illuminate\Database\Query\Expression $column + * @param string|\Illuminate\Database\Query\Expression $column * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17426,7 +17536,7 @@ public static function oldest($column = null) /** * Create a collection of models from plain arrays. * - * @param array $items + * @param array $items * @return \Illuminate\Database\Eloquent\Collection * @static */ @@ -17439,8 +17549,8 @@ public static function hydrate($items) /** * Create a collection of models from a raw query. * - * @param string $query - * @param array $bindings + * @param string $query + * @param array $bindings * @return \Illuminate\Database\Eloquent\Collection * @static */ @@ -17453,8 +17563,8 @@ public static function fromQuery($query, $bindings = []) /** * Find a model by its primary key. * - * @param mixed $id - * @param array $columns + * @param mixed $id + * @param array $columns * @return \Illuminate\Database\Eloquent\Model|\Illuminate\Database\Eloquent\Collection|static[]|static|null * @static */ @@ -17467,8 +17577,8 @@ public static function find($id, $columns = []) /** * Find multiple models by their primary keys. * - * @param \Illuminate\Contracts\Support\Arrayable|array $ids - * @param array $columns + * @param \Illuminate\Contracts\Support\Arrayable|array $ids + * @param array $columns * @return \Illuminate\Database\Eloquent\Collection * @static */ @@ -17481,9 +17591,10 @@ public static function findMany($ids, $columns = []) /** * Find a model by its primary key or throw an exception. * - * @param mixed $id - * @param array $columns + * @param mixed $id + * @param array $columns * @return \Illuminate\Database\Eloquent\Model|\Illuminate\Database\Eloquent\Collection|static|static[] + * * @throws \Illuminate\Database\Eloquent\ModelNotFoundException * @static */ @@ -17496,8 +17607,8 @@ public static function findOrFail($id, $columns = []) /** * Find a model by its primary key or return fresh model instance. * - * @param mixed $id - * @param array $columns + * @param mixed $id + * @param array $columns * @return \Illuminate\Database\Eloquent\Model|static * @static */ @@ -17510,8 +17621,8 @@ public static function findOrNew($id, $columns = []) /** * Get the first record matching the attributes or instantiate it. * - * @param array $attributes - * @param array $values + * @param array $attributes + * @param array $values * @return \Illuminate\Database\Eloquent\Model|static * @static */ @@ -17524,8 +17635,8 @@ public static function firstOrNew($attributes = [], $values = []) /** * Get the first record matching the attributes or create it. * - * @param array $attributes - * @param array $values + * @param array $attributes + * @param array $values * @return \Illuminate\Database\Eloquent\Model|static * @static */ @@ -17538,8 +17649,8 @@ public static function firstOrCreate($attributes = [], $values = []) /** * Create or update a record matching the attributes, and fill it with values. * - * @param array $attributes - * @param array $values + * @param array $attributes + * @param array $values * @return \Illuminate\Database\Eloquent\Model|static * @static */ @@ -17552,8 +17663,9 @@ public static function updateOrCreate($attributes, $values = []) /** * Execute the query and get the first result or throw an exception. * - * @param array $columns + * @param array $columns * @return \Illuminate\Database\Eloquent\Model|static + * * @throws \Illuminate\Database\Eloquent\ModelNotFoundException * @static */ @@ -17566,8 +17678,8 @@ public static function firstOrFail($columns = []) /** * Execute the query and get the first result or call a callback. * - * @param \Closure|array $columns - * @param \Closure|null $callback + * @param \Closure|array $columns + * @param \Closure|null $callback * @return \Illuminate\Database\Eloquent\Model|static|mixed * @static */ @@ -17580,7 +17692,7 @@ public static function firstOr($columns = [], $callback = null) /** * Get a single column's value from the first result of a query. * - * @param string|\Illuminate\Database\Query\Expression $column + * @param string|\Illuminate\Database\Query\Expression $column * @return mixed * @static */ @@ -17593,7 +17705,7 @@ public static function value($column) /** * Execute the query as a "select" statement. * - * @param array|string $columns + * @param array|string $columns * @return \Illuminate\Database\Eloquent\Collection|static[] * @static */ @@ -17606,7 +17718,7 @@ public static function get($columns = []) /** * Get the hydrated models without eager loading. * - * @param array|string $columns + * @param array|string $columns * @return \Illuminate\Database\Eloquent\Model[]|static[] * @static */ @@ -17619,7 +17731,7 @@ public static function getModels($columns = []) /** * Eager load the relationships for the models. * - * @param array $models + * @param array $models * @return array * @static */ @@ -17644,8 +17756,8 @@ public static function cursor() /** * Get an array with the values of a given column. * - * @param string|\Illuminate\Database\Query\Expression $column - * @param string|null $key + * @param string|\Illuminate\Database\Query\Expression $column + * @param string|null $key * @return \Illuminate\Support\Collection * @static */ @@ -17658,11 +17770,12 @@ public static function pluck($column, $key = null) /** * Paginate the given query. * - * @param int|null $perPage - * @param array $columns - * @param string $pageName - * @param int|null $page + * @param int|null $perPage + * @param array $columns + * @param string $pageName + * @param int|null $page * @return \Illuminate\Contracts\Pagination\LengthAwarePaginator + * * @throws \InvalidArgumentException * @static */ @@ -17675,10 +17788,10 @@ public static function paginate($perPage = null, $columns = [], $pageName = 'pag /** * Paginate the given query into a simple paginator. * - * @param int|null $perPage - * @param array $columns - * @param string $pageName - * @param int|null $page + * @param int|null $perPage + * @param array $columns + * @param string $pageName + * @param int|null $page * @return \Illuminate\Contracts\Pagination\Paginator * @static */ @@ -17691,7 +17804,7 @@ public static function simplePaginate($perPage = null, $columns = [], $pageName /** * Save a new model and return the instance. * - * @param array $attributes + * @param array $attributes * @return \Illuminate\Database\Eloquent\Model|$this * @static */ @@ -17704,7 +17817,7 @@ public static function create($attributes = []) /** * Save a new model and return the instance. Allow mass-assignment. * - * @param array $attributes + * @param array $attributes * @return \Illuminate\Database\Eloquent\Model|$this * @static */ @@ -17717,9 +17830,9 @@ public static function forceCreate($attributes) /** * Insert new records or update the existing ones. * - * @param array $values - * @param array|string $uniqueBy - * @param array|null $update + * @param array $values + * @param array|string $uniqueBy + * @param array|null $update * @return int * @static */ @@ -17732,7 +17845,7 @@ public static function upsert($values, $uniqueBy, $update = null) /** * Register a replacement for the default delete function. * - * @param \Closure $callback + * @param \Closure $callback * @return void * @static */ @@ -17745,7 +17858,7 @@ public static function onDelete($callback) /** * Call the given local model scopes. * - * @param array|string $scopes + * @param array|string $scopes * @return static|mixed * @static */ @@ -17770,7 +17883,7 @@ public static function applyScopes() /** * Prevent the specified relations from being eager loaded. * - * @param mixed $relations + * @param mixed $relations * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17783,7 +17896,7 @@ public static function without($relations) /** * Create a new instance of the model being queried. * - * @param array $attributes + * @param array $attributes * @return \Illuminate\Database\Eloquent\Model|static * @static */ @@ -17796,7 +17909,7 @@ public static function newModelInstance($attributes = []) /** * Apply query-time casts to the model instance. * - * @param array $casts + * @param array $casts * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17821,7 +17934,7 @@ public static function getQuery() /** * Set the underlying query builder instance. * - * @param \Illuminate\Database\Query\Builder $query + * @param \Illuminate\Database\Query\Builder $query * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17858,7 +17971,7 @@ public static function getEagerLoads() /** * Set the relationships being eagerly loaded. * - * @param array $eagerLoad + * @param array $eagerLoad * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17883,7 +17996,7 @@ public static function getModel() /** * Set a model instance for the model being queried. * - * @param \Illuminate\Database\Eloquent\Model $model + * @param \Illuminate\Database\Eloquent\Model $model * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -17896,7 +18009,7 @@ public static function setModel($model) /** * Get the given macro by name. * - * @param string $name + * @param string $name * @return \Closure * @static */ @@ -17909,7 +18022,7 @@ public static function getMacro($name) /** * Checks if a macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -17922,7 +18035,7 @@ public static function hasMacro($name) /** * Get the given global macro by name. * - * @param string $name + * @param string $name * @return \Closure * @static */ @@ -17934,7 +18047,7 @@ public static function getGlobalMacro($name) /** * Checks if a global macro is registered. * - * @param string $name + * @param string $name * @return bool * @static */ @@ -17946,8 +18059,8 @@ public static function hasGlobalMacro($name) /** * Chunk the results of the query. * - * @param int $count - * @param callable $callback + * @param int $count + * @param callable $callback * @return bool * @static */ @@ -17960,8 +18073,8 @@ public static function chunk($count, $callback) /** * Execute a callback over each item while chunking. * - * @param callable $callback - * @param int $count + * @param callable $callback + * @param int $count * @return bool * @static */ @@ -17974,10 +18087,10 @@ public static function each($callback, $count = 1000) /** * Chunk the results of a query by comparing IDs. * - * @param int $count - * @param callable $callback - * @param string|null $column - * @param string|null $alias + * @param int $count + * @param callable $callback + * @param string|null $column + * @param string|null $alias * @return bool * @static */ @@ -17990,10 +18103,10 @@ public static function chunkById($count, $callback, $column = null, $alias = nul /** * Execute a callback over each item while chunking by ID. * - * @param callable $callback - * @param int $count - * @param string|null $column - * @param string|null $alias + * @param callable $callback + * @param int $count + * @param string|null $column + * @param string|null $alias * @return bool * @static */ @@ -18006,7 +18119,7 @@ public static function eachById($callback, $count = 1000, $column = null, $alias /** * Execute the query and get the first result. * - * @param array|string $columns + * @param array|string $columns * @return \Illuminate\Database\Eloquent\Model|object|static|null * @static */ @@ -18019,9 +18132,9 @@ public static function first($columns = []) /** * Apply the callback's query changes if the given "value" is true. * - * @param mixed $value - * @param callable $callback - * @param callable|null $default + * @param mixed $value + * @param callable $callback + * @param callable|null $default * @return mixed|$this * @static */ @@ -18034,7 +18147,7 @@ public static function when($value, $callback, $default = null) /** * Pass the query to a given callback. * - * @param callable $callback + * @param callable $callback * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18047,9 +18160,9 @@ public static function tap($callback) /** * Apply the callback's query changes if the given "value" is false. * - * @param mixed $value - * @param callable $callback - * @param callable|null $default + * @param mixed $value + * @param callable $callback + * @param callable|null $default * @return mixed|$this * @static */ @@ -18062,12 +18175,13 @@ public static function unless($value, $callback, $default = null) /** * Add a relationship count / exists condition to the query. * - * @param \Illuminate\Database\Eloquent\Relations\Relation|string $relation - * @param string $operator - * @param int $count - * @param string $boolean - * @param \Closure|null $callback + * @param \Illuminate\Database\Eloquent\Relations\Relation|string $relation + * @param string $operator + * @param int $count + * @param string $boolean + * @param \Closure|null $callback * @return \Illuminate\Database\Eloquent\Builder|static + * * @throws \RuntimeException * @static */ @@ -18080,9 +18194,9 @@ public static function has($relation, $operator = '>=', $count = 1, $boolean = ' /** * Add a relationship count / exists condition to the query with an "or". * - * @param string $relation - * @param string $operator - * @param int $count + * @param string $relation + * @param string $operator + * @param int $count * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18095,9 +18209,9 @@ public static function orHas($relation, $operator = '>=', $count = 1) /** * Add a relationship count / exists condition to the query. * - * @param string $relation - * @param string $boolean - * @param \Closure|null $callback + * @param string $relation + * @param string $boolean + * @param \Closure|null $callback * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18110,7 +18224,7 @@ public static function doesntHave($relation, $boolean = 'and', $callback = null) /** * Add a relationship count / exists condition to the query with an "or". * - * @param string $relation + * @param string $relation * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18123,10 +18237,10 @@ public static function orDoesntHave($relation) /** * Add a relationship count / exists condition to the query with where clauses. * - * @param string $relation - * @param \Closure|null $callback - * @param string $operator - * @param int $count + * @param string $relation + * @param \Closure|null $callback + * @param string $operator + * @param int $count * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18139,10 +18253,10 @@ public static function whereHas($relation, $callback = null, $operator = '>=', $ /** * Add a relationship count / exists condition to the query with where clauses and an "or". * - * @param string $relation - * @param \Closure|null $callback - * @param string $operator - * @param int $count + * @param string $relation + * @param \Closure|null $callback + * @param string $operator + * @param int $count * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18155,8 +18269,8 @@ public static function orWhereHas($relation, $callback = null, $operator = '>=', /** * Add a relationship count / exists condition to the query with where clauses. * - * @param string $relation - * @param \Closure|null $callback + * @param string $relation + * @param \Closure|null $callback * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18169,8 +18283,8 @@ public static function whereDoesntHave($relation, $callback = null) /** * Add a relationship count / exists condition to the query with where clauses and an "or". * - * @param string $relation - * @param \Closure|null $callback + * @param string $relation + * @param \Closure|null $callback * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18183,12 +18297,12 @@ public static function orWhereDoesntHave($relation, $callback = null) /** * Add a polymorphic relationship count / exists condition to the query. * - * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation - * @param string|array $types - * @param string $operator - * @param int $count - * @param string $boolean - * @param \Closure|null $callback + * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation + * @param string|array $types + * @param string $operator + * @param int $count + * @param string $boolean + * @param \Closure|null $callback * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18201,10 +18315,10 @@ public static function hasMorph($relation, $types, $operator = '>=', $count = 1, /** * Add a polymorphic relationship count / exists condition to the query with an "or". * - * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation - * @param string|array $types - * @param string $operator - * @param int $count + * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation + * @param string|array $types + * @param string $operator + * @param int $count * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18217,10 +18331,10 @@ public static function orHasMorph($relation, $types, $operator = '>=', $count = /** * Add a polymorphic relationship count / exists condition to the query. * - * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation - * @param string|array $types - * @param string $boolean - * @param \Closure|null $callback + * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation + * @param string|array $types + * @param string $boolean + * @param \Closure|null $callback * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18233,8 +18347,8 @@ public static function doesntHaveMorph($relation, $types, $boolean = 'and', $cal /** * Add a polymorphic relationship count / exists condition to the query with an "or". * - * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation - * @param string|array $types + * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation + * @param string|array $types * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18247,11 +18361,11 @@ public static function orDoesntHaveMorph($relation, $types) /** * Add a polymorphic relationship count / exists condition to the query with where clauses. * - * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation - * @param string|array $types - * @param \Closure|null $callback - * @param string $operator - * @param int $count + * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation + * @param string|array $types + * @param \Closure|null $callback + * @param string $operator + * @param int $count * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18264,11 +18378,11 @@ public static function whereHasMorph($relation, $types, $callback = null, $opera /** * Add a polymorphic relationship count / exists condition to the query with where clauses and an "or". * - * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation - * @param string|array $types - * @param \Closure|null $callback - * @param string $operator - * @param int $count + * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation + * @param string|array $types + * @param \Closure|null $callback + * @param string $operator + * @param int $count * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18281,9 +18395,9 @@ public static function orWhereHasMorph($relation, $types, $callback = null, $ope /** * Add a polymorphic relationship count / exists condition to the query with where clauses. * - * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation - * @param string|array $types - * @param \Closure|null $callback + * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation + * @param string|array $types + * @param \Closure|null $callback * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18296,9 +18410,9 @@ public static function whereDoesntHaveMorph($relation, $types, $callback = null) /** * Add a polymorphic relationship count / exists condition to the query with where clauses and an "or". * - * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation - * @param string|array $types - * @param \Closure|null $callback + * @param \Illuminate\Database\Eloquent\Relations\MorphTo|string $relation + * @param string|array $types + * @param \Closure|null $callback * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18311,9 +18425,9 @@ public static function orWhereDoesntHaveMorph($relation, $types, $callback = nul /** * Add subselect queries to include an aggregate value for a relationship. * - * @param mixed $relations - * @param string $column - * @param string $function + * @param mixed $relations + * @param string $column + * @param string $function * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18326,7 +18440,7 @@ public static function withAggregate($relations, $column, $function = null) /** * Add subselect queries to count the relations. * - * @param mixed $relations + * @param mixed $relations * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18339,8 +18453,8 @@ public static function withCount($relations) /** * Add subselect queries to include the max of the relation's column. * - * @param string $relation - * @param string $column + * @param string $relation + * @param string $column * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18353,8 +18467,8 @@ public static function withMax($relation, $column) /** * Add subselect queries to include the min of the relation's column. * - * @param string $relation - * @param string $column + * @param string $relation + * @param string $column * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18367,8 +18481,8 @@ public static function withMin($relation, $column) /** * Add subselect queries to include the sum of the relation's column. * - * @param string $relation - * @param string $column + * @param string $relation + * @param string $column * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18381,8 +18495,8 @@ public static function withSum($relation, $column) /** * Add subselect queries to include the average of the relation's column. * - * @param string $relation - * @param string $column + * @param string $relation + * @param string $column * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18395,7 +18509,7 @@ public static function withAvg($relation, $column) /** * Merge the where constraints from another query to the current query. * - * @param \Illuminate\Database\Eloquent\Builder $from + * @param \Illuminate\Database\Eloquent\Builder $from * @return \Illuminate\Database\Eloquent\Builder|static * @static */ @@ -18420,7 +18534,7 @@ public static function explain() /** * Set the columns to be selected. * - * @param array|mixed $columns + * @param array|mixed $columns * @return \Illuminate\Database\Query\Builder * @static */ @@ -18433,9 +18547,10 @@ public static function select($columns = []) /** * Add a subselect expression to the query. * - * @param \Closure|$this|string $query - * @param string $as + * @param \Closure|$this|string $query + * @param string $as * @return \Illuminate\Database\Query\Builder + * * @throws \InvalidArgumentException * @static */ @@ -18448,8 +18563,8 @@ public static function selectSub($query, $as) /** * Add a new "raw" select expression to the query. * - * @param string $expression - * @param array $bindings + * @param string $expression + * @param array $bindings * @return \Illuminate\Database\Query\Builder * @static */ @@ -18462,9 +18577,10 @@ public static function selectRaw($expression, $bindings = []) /** * Makes "from" fetch from a subquery. * - * @param \Closure|\Illuminate\Database\Query\Builder|string $query - * @param string $as + * @param \Closure|\Illuminate\Database\Query\Builder|string $query + * @param string $as * @return \Illuminate\Database\Query\Builder + * * @throws \InvalidArgumentException * @static */ @@ -18477,8 +18593,8 @@ public static function fromSub($query, $as) /** * Add a raw from clause to the query. * - * @param string $expression - * @param mixed $bindings + * @param string $expression + * @param mixed $bindings * @return \Illuminate\Database\Query\Builder * @static */ @@ -18491,7 +18607,7 @@ public static function fromRaw($expression, $bindings = []) /** * Add a new select column to the query. * - * @param array|mixed $column + * @param array|mixed $column * @return \Illuminate\Database\Query\Builder * @static */ @@ -18516,8 +18632,8 @@ public static function distinct() /** * Set the table which the query is targeting. * - * @param \Closure|\Illuminate\Database\Query\Builder|string $table - * @param string|null $as + * @param \Closure|\Illuminate\Database\Query\Builder|string $table + * @param string|null $as * @return \Illuminate\Database\Query\Builder * @static */ @@ -18530,12 +18646,12 @@ public static function from($table, $as = null) /** * Add a join clause to the query. * - * @param string $table - * @param \Closure|string $first - * @param string|null $operator - * @param string|null $second - * @param string $type - * @param bool $where + * @param string $table + * @param \Closure|string $first + * @param string|null $operator + * @param string|null $second + * @param string $type + * @param bool $where * @return \Illuminate\Database\Query\Builder * @static */ @@ -18548,11 +18664,11 @@ public static function join($table, $first, $operator = null, $second = null, $t /** * Add a "join where" clause to the query. * - * @param string $table - * @param \Closure|string $first - * @param string $operator - * @param string $second - * @param string $type + * @param string $table + * @param \Closure|string $first + * @param string $operator + * @param string $second + * @param string $type * @return \Illuminate\Database\Query\Builder * @static */ @@ -18565,14 +18681,15 @@ public static function joinWhere($table, $first, $operator, $second, $type = 'in /** * Add a subquery join clause to the query. * - * @param \Closure|\Illuminate\Database\Query\Builder|string $query - * @param string $as - * @param \Closure|string $first - * @param string|null $operator - * @param string|null $second - * @param string $type - * @param bool $where + * @param \Closure|\Illuminate\Database\Query\Builder|string $query + * @param string $as + * @param \Closure|string $first + * @param string|null $operator + * @param string|null $second + * @param string $type + * @param bool $where * @return \Illuminate\Database\Query\Builder + * * @throws \InvalidArgumentException * @static */ @@ -18585,10 +18702,10 @@ public static function joinSub($query, $as, $first, $operator = null, $second = /** * Add a left join to the query. * - * @param string $table - * @param \Closure|string $first - * @param string|null $operator - * @param string|null $second + * @param string $table + * @param \Closure|string $first + * @param string|null $operator + * @param string|null $second * @return \Illuminate\Database\Query\Builder * @static */ @@ -18601,10 +18718,10 @@ public static function leftJoin($table, $first, $operator = null, $second = null /** * Add a "join where" clause to the query. * - * @param string $table - * @param \Closure|string $first - * @param string $operator - * @param string $second + * @param string $table + * @param \Closure|string $first + * @param string $operator + * @param string $second * @return \Illuminate\Database\Query\Builder * @static */ @@ -18617,11 +18734,11 @@ public static function leftJoinWhere($table, $first, $operator, $second) /** * Add a subquery left join to the query. * - * @param \Closure|\Illuminate\Database\Query\Builder|string $query - * @param string $as - * @param \Closure|string $first - * @param string|null $operator - * @param string|null $second + * @param \Closure|\Illuminate\Database\Query\Builder|string $query + * @param string $as + * @param \Closure|string $first + * @param string|null $operator + * @param string|null $second * @return \Illuminate\Database\Query\Builder * @static */ @@ -18634,10 +18751,10 @@ public static function leftJoinSub($query, $as, $first, $operator = null, $secon /** * Add a right join to the query. * - * @param string $table - * @param \Closure|string $first - * @param string|null $operator - * @param string|null $second + * @param string $table + * @param \Closure|string $first + * @param string|null $operator + * @param string|null $second * @return \Illuminate\Database\Query\Builder * @static */ @@ -18650,10 +18767,10 @@ public static function rightJoin($table, $first, $operator = null, $second = nul /** * Add a "right join where" clause to the query. * - * @param string $table - * @param \Closure|string $first - * @param string $operator - * @param string $second + * @param string $table + * @param \Closure|string $first + * @param string $operator + * @param string $second * @return \Illuminate\Database\Query\Builder * @static */ @@ -18666,11 +18783,11 @@ public static function rightJoinWhere($table, $first, $operator, $second) /** * Add a subquery right join to the query. * - * @param \Closure|\Illuminate\Database\Query\Builder|string $query - * @param string $as - * @param \Closure|string $first - * @param string|null $operator - * @param string|null $second + * @param \Closure|\Illuminate\Database\Query\Builder|string $query + * @param string $as + * @param \Closure|string $first + * @param string|null $operator + * @param string|null $second * @return \Illuminate\Database\Query\Builder * @static */ @@ -18683,10 +18800,10 @@ public static function rightJoinSub($query, $as, $first, $operator = null, $seco /** * Add a "cross join" clause to the query. * - * @param string $table - * @param \Closure|string|null $first - * @param string|null $operator - * @param string|null $second + * @param string $table + * @param \Closure|string|null $first + * @param string|null $operator + * @param string|null $second * @return \Illuminate\Database\Query\Builder * @static */ @@ -18699,8 +18816,8 @@ public static function crossJoin($table, $first = null, $operator = null, $secon /** * Add a subquery cross join to the query. * - * @param \Closure|\Illuminate\Database\Query\Builder|string $query - * @param string $as + * @param \Closure|\Illuminate\Database\Query\Builder|string $query + * @param string $as * @return \Illuminate\Database\Query\Builder * @static */ @@ -18713,8 +18830,8 @@ public static function crossJoinSub($query, $as) /** * Merge an array of where clauses and bindings. * - * @param array $wheres - * @param array $bindings + * @param array $wheres + * @param array $bindings * @return void * @static */ @@ -18727,10 +18844,11 @@ public static function mergeWheres($wheres, $bindings) /** * Prepare the value and operator for a where clause. * - * @param string $value - * @param string $operator - * @param bool $useDefault + * @param string $value + * @param string $operator + * @param bool $useDefault * @return array + * * @throws \InvalidArgumentException * @static */ @@ -18743,10 +18861,10 @@ public static function prepareValueAndOperator($value, $operator, $useDefault = /** * Add a "where" clause comparing two columns to the query. * - * @param string|array $first - * @param string|null $operator - * @param string|null $second - * @param string|null $boolean + * @param string|array $first + * @param string|null $operator + * @param string|null $second + * @param string|null $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -18759,9 +18877,9 @@ public static function whereColumn($first, $operator = null, $second = null, $bo /** * Add an "or where" clause comparing two columns to the query. * - * @param string|array $first - * @param string|null $operator - * @param string|null $second + * @param string|array $first + * @param string|null $operator + * @param string|null $second * @return \Illuminate\Database\Query\Builder * @static */ @@ -18774,9 +18892,9 @@ public static function orWhereColumn($first, $operator = null, $second = null) /** * Add a raw where clause to the query. * - * @param string $sql - * @param mixed $bindings - * @param string $boolean + * @param string $sql + * @param mixed $bindings + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -18789,8 +18907,8 @@ public static function whereRaw($sql, $bindings = [], $boolean = 'and') /** * Add a raw or where clause to the query. * - * @param string $sql - * @param mixed $bindings + * @param string $sql + * @param mixed $bindings * @return \Illuminate\Database\Query\Builder * @static */ @@ -18803,10 +18921,10 @@ public static function orWhereRaw($sql, $bindings = []) /** * Add a "where in" clause to the query. * - * @param string $column - * @param mixed $values - * @param string $boolean - * @param bool $not + * @param string $column + * @param mixed $values + * @param string $boolean + * @param bool $not * @return \Illuminate\Database\Query\Builder * @static */ @@ -18819,8 +18937,8 @@ public static function whereIn($column, $values, $boolean = 'and', $not = false) /** * Add an "or where in" clause to the query. * - * @param string $column - * @param mixed $values + * @param string $column + * @param mixed $values * @return \Illuminate\Database\Query\Builder * @static */ @@ -18833,9 +18951,9 @@ public static function orWhereIn($column, $values) /** * Add a "where not in" clause to the query. * - * @param string $column - * @param mixed $values - * @param string $boolean + * @param string $column + * @param mixed $values + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -18848,8 +18966,8 @@ public static function whereNotIn($column, $values, $boolean = 'and') /** * Add an "or where not in" clause to the query. * - * @param string $column - * @param mixed $values + * @param string $column + * @param mixed $values * @return \Illuminate\Database\Query\Builder * @static */ @@ -18862,10 +18980,10 @@ public static function orWhereNotIn($column, $values) /** * Add a "where in raw" clause for integer values to the query. * - * @param string $column - * @param \Illuminate\Contracts\Support\Arrayable|array $values - * @param string $boolean - * @param bool $not + * @param string $column + * @param \Illuminate\Contracts\Support\Arrayable|array $values + * @param string $boolean + * @param bool $not * @return \Illuminate\Database\Query\Builder * @static */ @@ -18878,8 +18996,8 @@ public static function whereIntegerInRaw($column, $values, $boolean = 'and', $no /** * Add an "or where in raw" clause for integer values to the query. * - * @param string $column - * @param \Illuminate\Contracts\Support\Arrayable|array $values + * @param string $column + * @param \Illuminate\Contracts\Support\Arrayable|array $values * @return \Illuminate\Database\Query\Builder * @static */ @@ -18892,9 +19010,9 @@ public static function orWhereIntegerInRaw($column, $values) /** * Add a "where not in raw" clause for integer values to the query. * - * @param string $column - * @param \Illuminate\Contracts\Support\Arrayable|array $values - * @param string $boolean + * @param string $column + * @param \Illuminate\Contracts\Support\Arrayable|array $values + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -18907,8 +19025,8 @@ public static function whereIntegerNotInRaw($column, $values, $boolean = 'and') /** * Add an "or where not in raw" clause for integer values to the query. * - * @param string $column - * @param \Illuminate\Contracts\Support\Arrayable|array $values + * @param string $column + * @param \Illuminate\Contracts\Support\Arrayable|array $values * @return \Illuminate\Database\Query\Builder * @static */ @@ -18921,9 +19039,9 @@ public static function orWhereIntegerNotInRaw($column, $values) /** * Add a "where null" clause to the query. * - * @param string|array $columns - * @param string $boolean - * @param bool $not + * @param string|array $columns + * @param string $boolean + * @param bool $not * @return \Illuminate\Database\Query\Builder * @static */ @@ -18936,7 +19054,7 @@ public static function whereNull($columns, $boolean = 'and', $not = false) /** * Add an "or where null" clause to the query. * - * @param string $column + * @param string $column * @return \Illuminate\Database\Query\Builder * @static */ @@ -18949,8 +19067,8 @@ public static function orWhereNull($column) /** * Add a "where not null" clause to the query. * - * @param string|array $columns - * @param string $boolean + * @param string|array $columns + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -18963,10 +19081,10 @@ public static function whereNotNull($columns, $boolean = 'and') /** * Add a where between statement to the query. * - * @param string|\Illuminate\Database\Query\Expression $column - * @param array $values - * @param string $boolean - * @param bool $not + * @param string|\Illuminate\Database\Query\Expression $column + * @param array $values + * @param string $boolean + * @param bool $not * @return \Illuminate\Database\Query\Builder * @static */ @@ -18979,10 +19097,10 @@ public static function whereBetween($column, $values, $boolean = 'and', $not = f /** * Add a where between statement using columns to the query. * - * @param string $column - * @param array $values - * @param string $boolean - * @param bool $not + * @param string $column + * @param array $values + * @param string $boolean + * @param bool $not * @return \Illuminate\Database\Query\Builder * @static */ @@ -18995,8 +19113,8 @@ public static function whereBetweenColumns($column, $values, $boolean = 'and', $ /** * Add an or where between statement to the query. * - * @param string $column - * @param array $values + * @param string $column + * @param array $values * @return \Illuminate\Database\Query\Builder * @static */ @@ -19009,8 +19127,8 @@ public static function orWhereBetween($column, $values) /** * Add an or where between statement using columns to the query. * - * @param string $column - * @param array $values + * @param string $column + * @param array $values * @return \Illuminate\Database\Query\Builder * @static */ @@ -19023,9 +19141,9 @@ public static function orWhereBetweenColumns($column, $values) /** * Add a where not between statement to the query. * - * @param string $column - * @param array $values - * @param string $boolean + * @param string $column + * @param array $values + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19038,9 +19156,9 @@ public static function whereNotBetween($column, $values, $boolean = 'and') /** * Add a where not between statement using columns to the query. * - * @param string $column - * @param array $values - * @param string $boolean + * @param string $column + * @param array $values + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19053,8 +19171,8 @@ public static function whereNotBetweenColumns($column, $values, $boolean = 'and' /** * Add an or where not between statement to the query. * - * @param string $column - * @param array $values + * @param string $column + * @param array $values * @return \Illuminate\Database\Query\Builder * @static */ @@ -19067,8 +19185,8 @@ public static function orWhereNotBetween($column, $values) /** * Add an or where not between statement using columns to the query. * - * @param string $column - * @param array $values + * @param string $column + * @param array $values * @return \Illuminate\Database\Query\Builder * @static */ @@ -19081,7 +19199,7 @@ public static function orWhereNotBetweenColumns($column, $values) /** * Add an "or where not null" clause to the query. * - * @param string $column + * @param string $column * @return \Illuminate\Database\Query\Builder * @static */ @@ -19094,10 +19212,10 @@ public static function orWhereNotNull($column) /** * Add a "where date" statement to the query. * - * @param string $column - * @param string $operator - * @param \DateTimeInterface|string|null $value - * @param string $boolean + * @param string $column + * @param string $operator + * @param \DateTimeInterface|string|null $value + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19110,9 +19228,9 @@ public static function whereDate($column, $operator, $value = null, $boolean = ' /** * Add an "or where date" statement to the query. * - * @param string $column - * @param string $operator - * @param \DateTimeInterface|string|null $value + * @param string $column + * @param string $operator + * @param \DateTimeInterface|string|null $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19125,10 +19243,10 @@ public static function orWhereDate($column, $operator, $value = null) /** * Add a "where time" statement to the query. * - * @param string $column - * @param string $operator - * @param \DateTimeInterface|string|null $value - * @param string $boolean + * @param string $column + * @param string $operator + * @param \DateTimeInterface|string|null $value + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19141,9 +19259,9 @@ public static function whereTime($column, $operator, $value = null, $boolean = ' /** * Add an "or where time" statement to the query. * - * @param string $column - * @param string $operator - * @param \DateTimeInterface|string|null $value + * @param string $column + * @param string $operator + * @param \DateTimeInterface|string|null $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19156,10 +19274,10 @@ public static function orWhereTime($column, $operator, $value = null) /** * Add a "where day" statement to the query. * - * @param string $column - * @param string $operator - * @param \DateTimeInterface|string|null $value - * @param string $boolean + * @param string $column + * @param string $operator + * @param \DateTimeInterface|string|null $value + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19172,9 +19290,9 @@ public static function whereDay($column, $operator, $value = null, $boolean = 'a /** * Add an "or where day" statement to the query. * - * @param string $column - * @param string $operator - * @param \DateTimeInterface|string|null $value + * @param string $column + * @param string $operator + * @param \DateTimeInterface|string|null $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19187,10 +19305,10 @@ public static function orWhereDay($column, $operator, $value = null) /** * Add a "where month" statement to the query. * - * @param string $column - * @param string $operator - * @param \DateTimeInterface|string|null $value - * @param string $boolean + * @param string $column + * @param string $operator + * @param \DateTimeInterface|string|null $value + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19203,9 +19321,9 @@ public static function whereMonth($column, $operator, $value = null, $boolean = /** * Add an "or where month" statement to the query. * - * @param string $column - * @param string $operator - * @param \DateTimeInterface|string|null $value + * @param string $column + * @param string $operator + * @param \DateTimeInterface|string|null $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19218,10 +19336,10 @@ public static function orWhereMonth($column, $operator, $value = null) /** * Add a "where year" statement to the query. * - * @param string $column - * @param string $operator - * @param \DateTimeInterface|string|int|null $value - * @param string $boolean + * @param string $column + * @param string $operator + * @param \DateTimeInterface|string|int|null $value + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19234,9 +19352,9 @@ public static function whereYear($column, $operator, $value = null, $boolean = ' /** * Add an "or where year" statement to the query. * - * @param string $column - * @param string $operator - * @param \DateTimeInterface|string|int|null $value + * @param string $column + * @param string $operator + * @param \DateTimeInterface|string|int|null $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19249,8 +19367,8 @@ public static function orWhereYear($column, $operator, $value = null) /** * Add a nested where statement to the query. * - * @param \Closure $callback - * @param string $boolean + * @param \Closure $callback + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19275,8 +19393,8 @@ public static function forNestedWhere() /** * Add another query builder as a nested where to the query builder. * - * @param \Illuminate\Database\Query\Builder $query - * @param string $boolean + * @param \Illuminate\Database\Query\Builder $query + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19289,9 +19407,9 @@ public static function addNestedWhereQuery($query, $boolean = 'and') /** * Add an exists clause to the query. * - * @param \Closure $callback - * @param string $boolean - * @param bool $not + * @param \Closure $callback + * @param string $boolean + * @param bool $not * @return \Illuminate\Database\Query\Builder * @static */ @@ -19304,8 +19422,8 @@ public static function whereExists($callback, $boolean = 'and', $not = false) /** * Add an or exists clause to the query. * - * @param \Closure $callback - * @param bool $not + * @param \Closure $callback + * @param bool $not * @return \Illuminate\Database\Query\Builder * @static */ @@ -19318,8 +19436,8 @@ public static function orWhereExists($callback, $not = false) /** * Add a where not exists clause to the query. * - * @param \Closure $callback - * @param string $boolean + * @param \Closure $callback + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19332,7 +19450,7 @@ public static function whereNotExists($callback, $boolean = 'and') /** * Add a where not exists clause to the query. * - * @param \Closure $callback + * @param \Closure $callback * @return \Illuminate\Database\Query\Builder * @static */ @@ -19345,9 +19463,9 @@ public static function orWhereNotExists($callback) /** * Add an exists clause to the query. * - * @param \Illuminate\Database\Query\Builder $query - * @param string $boolean - * @param bool $not + * @param \Illuminate\Database\Query\Builder $query + * @param string $boolean + * @param bool $not * @return \Illuminate\Database\Query\Builder * @static */ @@ -19360,11 +19478,12 @@ public static function addWhereExistsQuery($query, $boolean = 'and', $not = fals /** * Adds a where condition using row values. * - * @param array $columns - * @param string $operator - * @param array $values - * @param string $boolean + * @param array $columns + * @param string $operator + * @param array $values + * @param string $boolean * @return \Illuminate\Database\Query\Builder + * * @throws \InvalidArgumentException * @static */ @@ -19377,9 +19496,9 @@ public static function whereRowValues($columns, $operator, $values, $boolean = ' /** * Adds an or where condition using row values. * - * @param array $columns - * @param string $operator - * @param array $values + * @param array $columns + * @param string $operator + * @param array $values * @return \Illuminate\Database\Query\Builder * @static */ @@ -19392,10 +19511,10 @@ public static function orWhereRowValues($columns, $operator, $values) /** * Add a "where JSON contains" clause to the query. * - * @param string $column - * @param mixed $value - * @param string $boolean - * @param bool $not + * @param string $column + * @param mixed $value + * @param string $boolean + * @param bool $not * @return \Illuminate\Database\Query\Builder * @static */ @@ -19408,8 +19527,8 @@ public static function whereJsonContains($column, $value, $boolean = 'and', $not /** * Add an "or where JSON contains" clause to the query. * - * @param string $column - * @param mixed $value + * @param string $column + * @param mixed $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19422,9 +19541,9 @@ public static function orWhereJsonContains($column, $value) /** * Add a "where JSON not contains" clause to the query. * - * @param string $column - * @param mixed $value - * @param string $boolean + * @param string $column + * @param mixed $value + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19437,8 +19556,8 @@ public static function whereJsonDoesntContain($column, $value, $boolean = 'and') /** * Add an "or where JSON not contains" clause to the query. * - * @param string $column - * @param mixed $value + * @param string $column + * @param mixed $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19451,10 +19570,10 @@ public static function orWhereJsonDoesntContain($column, $value) /** * Add a "where JSON length" clause to the query. * - * @param string $column - * @param mixed $operator - * @param mixed $value - * @param string $boolean + * @param string $column + * @param mixed $operator + * @param mixed $value + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19467,9 +19586,9 @@ public static function whereJsonLength($column, $operator, $value = null, $boole /** * Add an "or where JSON length" clause to the query. * - * @param string $column - * @param mixed $operator - * @param mixed $value + * @param string $column + * @param mixed $operator + * @param mixed $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19482,8 +19601,8 @@ public static function orWhereJsonLength($column, $operator, $value = null) /** * Handles dynamic "where" clauses to the query. * - * @param string $method - * @param array $parameters + * @param string $method + * @param array $parameters * @return \Illuminate\Database\Query\Builder * @static */ @@ -19496,7 +19615,7 @@ public static function dynamicWhere($method, $parameters) /** * Add a "group by" clause to the query. * - * @param array|string $groups + * @param array|string $groups * @return \Illuminate\Database\Query\Builder * @static */ @@ -19509,8 +19628,8 @@ public static function groupBy(...$groups) /** * Add a raw groupBy clause to the query. * - * @param string $sql - * @param array $bindings + * @param string $sql + * @param array $bindings * @return \Illuminate\Database\Query\Builder * @static */ @@ -19523,10 +19642,10 @@ public static function groupByRaw($sql, $bindings = []) /** * Add a "having" clause to the query. * - * @param string $column - * @param string|null $operator - * @param string|null $value - * @param string $boolean + * @param string $column + * @param string|null $operator + * @param string|null $value + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19539,9 +19658,9 @@ public static function having($column, $operator = null, $value = null, $boolean /** * Add an "or having" clause to the query. * - * @param string $column - * @param string|null $operator - * @param string|null $value + * @param string $column + * @param string|null $operator + * @param string|null $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19554,10 +19673,10 @@ public static function orHaving($column, $operator = null, $value = null) /** * Add a "having between " clause to the query. * - * @param string $column - * @param array $values - * @param string $boolean - * @param bool $not + * @param string $column + * @param array $values + * @param string $boolean + * @param bool $not * @return \Illuminate\Database\Query\Builder * @static */ @@ -19570,9 +19689,9 @@ public static function havingBetween($column, $values, $boolean = 'and', $not = /** * Add a raw having clause to the query. * - * @param string $sql - * @param array $bindings - * @param string $boolean + * @param string $sql + * @param array $bindings + * @param string $boolean * @return \Illuminate\Database\Query\Builder * @static */ @@ -19585,8 +19704,8 @@ public static function havingRaw($sql, $bindings = [], $boolean = 'and') /** * Add a raw or having clause to the query. * - * @param string $sql - * @param array $bindings + * @param string $sql + * @param array $bindings * @return \Illuminate\Database\Query\Builder * @static */ @@ -19599,9 +19718,10 @@ public static function orHavingRaw($sql, $bindings = []) /** * Add an "order by" clause to the query. * - * @param \Closure|\Illuminate\Database\Query\Builder|\Illuminate\Database\Query\Expression|string $column - * @param string $direction + * @param \Closure|\Illuminate\Database\Query\Builder|\Illuminate\Database\Query\Expression|string $column + * @param string $direction * @return \Illuminate\Database\Query\Builder + * * @throws \InvalidArgumentException * @static */ @@ -19614,7 +19734,7 @@ public static function orderBy($column, $direction = 'asc') /** * Add a descending "order by" clause to the query. * - * @param string $column + * @param string $column * @return \Illuminate\Database\Query\Builder * @static */ @@ -19627,7 +19747,7 @@ public static function orderByDesc($column) /** * Put the query's results in random order. * - * @param string $seed + * @param string $seed * @return \Illuminate\Database\Query\Builder * @static */ @@ -19640,8 +19760,8 @@ public static function inRandomOrder($seed = '') /** * Add a raw "order by" clause to the query. * - * @param string $sql - * @param array $bindings + * @param string $sql + * @param array $bindings * @return \Illuminate\Database\Query\Builder * @static */ @@ -19654,7 +19774,7 @@ public static function orderByRaw($sql, $bindings = []) /** * Alias to set the "offset" value of the query. * - * @param int $value + * @param int $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19667,7 +19787,7 @@ public static function skip($value) /** * Set the "offset" value of the query. * - * @param int $value + * @param int $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19680,7 +19800,7 @@ public static function offset($value) /** * Alias to set the "limit" value of the query. * - * @param int $value + * @param int $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19693,7 +19813,7 @@ public static function take($value) /** * Set the "limit" value of the query. * - * @param int $value + * @param int $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19706,8 +19826,8 @@ public static function limit($value) /** * Set the limit and offset for a given page. * - * @param int $page - * @param int $perPage + * @param int $page + * @param int $perPage * @return \Illuminate\Database\Query\Builder * @static */ @@ -19720,9 +19840,9 @@ public static function forPage($page, $perPage = 15) /** * Constrain the query to the previous "page" of results before a given ID. * - * @param int $perPage - * @param int|null $lastId - * @param string $column + * @param int $perPage + * @param int|null $lastId + * @param string $column * @return \Illuminate\Database\Query\Builder * @static */ @@ -19735,9 +19855,9 @@ public static function forPageBeforeId($perPage = 15, $lastId = 0, $column = 'id /** * Constrain the query to the next "page" of results after a given ID. * - * @param int $perPage - * @param int|null $lastId - * @param string $column + * @param int $perPage + * @param int|null $lastId + * @param string $column * @return \Illuminate\Database\Query\Builder * @static */ @@ -19750,8 +19870,8 @@ public static function forPageAfterId($perPage = 15, $lastId = 0, $column = 'id' /** * Remove all existing orders and optionally add a new order. * - * @param string|null $column - * @param string $direction + * @param string|null $column + * @param string $direction * @return \Illuminate\Database\Query\Builder * @static */ @@ -19764,8 +19884,8 @@ public static function reorder($column = null, $direction = 'asc') /** * Add a union statement to the query. * - * @param \Illuminate\Database\Query\Builder|\Closure $query - * @param bool $all + * @param \Illuminate\Database\Query\Builder|\Closure $query + * @param bool $all * @return \Illuminate\Database\Query\Builder * @static */ @@ -19778,7 +19898,7 @@ public static function union($query, $all = false) /** * Add a union all statement to the query. * - * @param \Illuminate\Database\Query\Builder|\Closure $query + * @param \Illuminate\Database\Query\Builder|\Closure $query * @return \Illuminate\Database\Query\Builder * @static */ @@ -19791,7 +19911,7 @@ public static function unionAll($query) /** * Lock the selected rows in the table. * - * @param string|bool $value + * @param string|bool $value * @return \Illuminate\Database\Query\Builder * @static */ @@ -19840,7 +19960,7 @@ public static function toSql() /** * Get the count of the total records for the paginator. * - * @param array $columns + * @param array $columns * @return int * @static */ @@ -19853,8 +19973,8 @@ public static function getCountForPagination($columns = []) /** * Concatenate values of a given column as a string. * - * @param string $column - * @param string $glue + * @param string $column + * @param string $glue * @return string * @static */ @@ -19891,7 +20011,7 @@ public static function doesntExist() /** * Execute the given callback if no rows exist for the current query. * - * @param \Closure $callback + * @param \Closure $callback * @return mixed * @static */ @@ -19904,7 +20024,7 @@ public static function existsOr($callback) /** * Execute the given callback if rows exist for the current query. * - * @param \Closure $callback + * @param \Closure $callback * @return mixed * @static */ @@ -19917,7 +20037,7 @@ public static function doesntExistOr($callback) /** * Retrieve the "count" result of the query. * - * @param string $columns + * @param string $columns * @return int * @static */ @@ -19930,7 +20050,7 @@ public static function count($columns = '*') /** * Retrieve the minimum value of a given column. * - * @param string $column + * @param string $column * @return mixed * @static */ @@ -19943,7 +20063,7 @@ public static function min($column) /** * Retrieve the maximum value of a given column. * - * @param string $column + * @param string $column * @return mixed * @static */ @@ -19956,7 +20076,7 @@ public static function max($column) /** * Retrieve the sum of the values of a given column. * - * @param string $column + * @param string $column * @return mixed * @static */ @@ -19969,7 +20089,7 @@ public static function sum($column) /** * Retrieve the average of the values of a given column. * - * @param string $column + * @param string $column * @return mixed * @static */ @@ -19982,7 +20102,7 @@ public static function avg($column) /** * Alias for the "avg" method. * - * @param string $column + * @param string $column * @return mixed * @static */ @@ -19995,8 +20115,8 @@ public static function average($column) /** * Execute an aggregate function on the database. * - * @param string $function - * @param array $columns + * @param string $function + * @param array $columns * @return mixed * @static */ @@ -20009,8 +20129,8 @@ public static function aggregate($function, $columns = []) /** * Execute a numeric aggregate function on the database. * - * @param string $function - * @param array $columns + * @param string $function + * @param array $columns * @return float|int * @static */ @@ -20023,7 +20143,7 @@ public static function numericAggregate($function, $columns = []) /** * Insert new records into the database. * - * @param array $values + * @param array $values * @return bool * @static */ @@ -20036,7 +20156,7 @@ public static function insert($values) /** * Insert new records into the database while ignoring errors. * - * @param array $values + * @param array $values * @return int * @static */ @@ -20049,8 +20169,8 @@ public static function insertOrIgnore($values) /** * Insert a new record and get the value of the primary key. * - * @param array $values - * @param string|null $sequence + * @param array $values + * @param string|null $sequence * @return int * @static */ @@ -20063,8 +20183,8 @@ public static function insertGetId($values, $sequence = null) /** * Insert new records into the table using a subquery. * - * @param array $columns - * @param \Closure|\Illuminate\Database\Query\Builder|string $query + * @param array $columns + * @param \Closure|\Illuminate\Database\Query\Builder|string $query * @return int * @static */ @@ -20077,8 +20197,8 @@ public static function insertUsing($columns, $query) /** * Insert or update a record matching the attributes, and fill it with values. * - * @param array $attributes - * @param array $values + * @param array $attributes + * @param array $values * @return bool * @static */ @@ -20103,7 +20223,7 @@ public static function truncate() /** * Create a raw database expression. * - * @param mixed $value + * @param mixed $value * @return \Illuminate\Database\Query\Expression * @static */ @@ -20140,9 +20260,10 @@ public static function getRawBindings() /** * Set the bindings on the query builder. * - * @param array $bindings - * @param string $type + * @param array $bindings + * @param string $type * @return \Illuminate\Database\Query\Builder + * * @throws \InvalidArgumentException * @static */ @@ -20155,9 +20276,10 @@ public static function setBindings($bindings, $type = 'where') /** * Add a binding to the query. * - * @param mixed $value - * @param string $type + * @param mixed $value + * @param string $type * @return \Illuminate\Database\Query\Builder + * * @throws \InvalidArgumentException * @static */ @@ -20170,7 +20292,7 @@ public static function addBinding($value, $type = 'where') /** * Merge an array of bindings into our bindings. * - * @param \Illuminate\Database\Query\Builder $query + * @param \Illuminate\Database\Query\Builder $query * @return \Illuminate\Database\Query\Builder * @static */ @@ -20183,7 +20305,7 @@ public static function mergeBindings($query) /** * Remove all of the expressions from a list of bindings. * - * @param array $bindings + * @param array $bindings * @return array * @static */ @@ -20244,7 +20366,7 @@ public static function clone() /** * Clone the query without the given properties. * - * @param array $properties + * @param array $properties * @return static * @static */ @@ -20257,7 +20379,7 @@ public static function cloneWithout($properties) /** * Clone the query without the given bindings. * - * @param array $except + * @param array $except * @return static * @static */ @@ -20294,8 +20416,8 @@ public static function dd() /** * Register a custom macro. * - * @param string $name - * @param object|callable $macro + * @param string $name + * @param object|callable $macro * @return void * @static */ @@ -20307,9 +20429,10 @@ public static function macro($name, $macro) /** * Mix another object into the class. * - * @param object $mixin - * @param bool $replace + * @param object $mixin + * @param bool $replace * @return void + * * @throws \ReflectionException * @static */ @@ -20321,9 +20444,10 @@ public static function mixin($mixin, $replace = true) /** * Dynamically handle calls to the class. * - * @param string $method - * @param array $parameters + * @param string $method + * @param array $parameters * @return mixed + * * @throws \BadMethodCallException * @static */ diff --git a/app/API2/Controllers/Comment.php b/app/API2/Controllers/Comment.php index 10cb6fdef..6703c42b5 100644 --- a/app/API2/Controllers/Comment.php +++ b/app/API2/Controllers/Comment.php @@ -29,6 +29,7 @@ class Comment extends Controller { /** * List all comments. + * * @param ListAllComments $request * @param CommentModel $model * @return JsonResponse diff --git a/app/API2/Controllers/Feed/Topic.php b/app/API2/Controllers/Feed/Topic.php index 281211f16..7f6d4ea98 100644 --- a/app/API2/Controllers/Feed/Topic.php +++ b/app/API2/Controllers/Feed/Topic.php @@ -83,7 +83,6 @@ public function listTopicsOnlyHot(Request $request, FeedTopicModel $model): Json * * @param \Zhiyi\Plus\Requests\Feed\TopicIndex $request * @param \Zhiyi\Plus\Models\FeedTopic $model - * * @return \Illuminate\Http\JsonResponse */ public function index(IndexRequest $request, FeedTopicModel $model): JsonResponse @@ -145,7 +144,6 @@ function (EloquentBuilder $query) use ($indexID, $direction) { * Create an topic. * * @param \Zhiyi\Plus\API2\Requests\Feed\CreateTopic $request - * * @return \Illuminate\Http\JsonResponse */ public function create(CreateTopicRequest $request): JsonResponse @@ -212,7 +210,6 @@ public function create(CreateTopicRequest $request): JsonResponse * * @param \Zhiyi\Plus\API2\Requests\Feed\EditTopic $request * @param \Zhiyi\Plus\Models\FeedTopic $topic - * * @return \Illuminate\Http\Response */ public function update(EditTopicRequest $request, FeedTopicModel $topic): Response @@ -241,7 +238,6 @@ public function update(EditTopicRequest $request, FeedTopicModel $topic): Respon * Get a single topic. * * @param \Zhiyi\Plus\Models\FeedTopic $topic - * * @return \Illuminate\Http\JsonResponse */ public function show(FeedTopicModel $topic): JsonResponse diff --git a/app/API2/Controllers/Feed/TopicFollow.php b/app/API2/Controllers/Feed/TopicFollow.php index 5df8d8345..3e31aebb4 100644 --- a/app/API2/Controllers/Feed/TopicFollow.php +++ b/app/API2/Controllers/Feed/TopicFollow.php @@ -43,7 +43,6 @@ public function __construct() * @param Request $request * @param FeedTopicModel $model * @param int $topicID - * * @return Response */ public function follow( @@ -102,7 +101,6 @@ public function follow( * @param Request $request * @param FeedTopicModel $model * @param int $topicID - * * @return Response */ public function unfollow( diff --git a/app/API2/Controllers/Feed/TopicParticipant.php b/app/API2/Controllers/Feed/TopicParticipant.php index 76c5688d5..f01a070d9 100644 --- a/app/API2/Controllers/Feed/TopicParticipant.php +++ b/app/API2/Controllers/Feed/TopicParticipant.php @@ -32,9 +32,9 @@ class TopicParticipant extends Controller /** * List participants for a topic. * - * @param \Zhiyi\Plus\API2\Requests\Feed\ListParticipantsForATopic $request - * @param \Zhiyi\Plus\Models\FeedTopicUserLink $model - * @param int $topic + * @param \Zhiyi\Plus\API2\Requests\Feed\ListParticipantsForATopic $request + * @param \Zhiyi\Plus\Models\FeedTopicUserLink $model + * @param int $topic * @return \Illuminate\Http\JsonResponse */ public function index(ListParticipantsForATopicRequest $request, FeedTopicUserLinkModel $model, int $topic): JsonResponse diff --git a/app/API2/Controllers/Feed/TopicReport.php b/app/API2/Controllers/Feed/TopicReport.php index a6ee70cfc..ca500a84c 100644 --- a/app/API2/Controllers/Feed/TopicReport.php +++ b/app/API2/Controllers/Feed/TopicReport.php @@ -39,8 +39,8 @@ public function __construct() /** * Report a topic. * - * @param \Zhiyi\Plus\API2\Requests\Feed\ReportATopic $request - * @param \Zhiyi\Plus\Models\FeedTopic $topic + * @param \Zhiyi\Plus\API2\Requests\Feed\ReportATopic $request + * @param \Zhiyi\Plus\Models\FeedTopic $topic * @return \Illuminate\Http\Response */ public function __invoke(ReportATopicRequest $request, FeedTopicModel $topic): Response diff --git a/app/API2/Controllers/NewsPostController.php b/app/API2/Controllers/NewsPostController.php index c10363734..808417612 100644 --- a/app/API2/Controllers/NewsPostController.php +++ b/app/API2/Controllers/NewsPostController.php @@ -36,7 +36,8 @@ public function __construct() /** * Destory a News post. - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentNews\Models\News $post + * + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentNews\Models\News $post * @return mixed */ public function destroy(News $post) diff --git a/app/API2/Controllers/NotificationController.php b/app/API2/Controllers/NotificationController.php index 116a316a6..3b6296e51 100644 --- a/app/API2/Controllers/NotificationController.php +++ b/app/API2/Controllers/NotificationController.php @@ -46,7 +46,8 @@ public function __construct() /** * Get the request notification type. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return string */ protected function getQueryType(Request $request, bool $getTypes = false) @@ -70,7 +71,8 @@ protected function getQueryType(Request $request, bool $getTypes = false) /** * Get the user notifications. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return mixed */ public function index(Request $request) @@ -88,7 +90,8 @@ public function index(Request $request) /** * Set notifications make read at. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return mixed */ public function update(Request $request) @@ -106,7 +109,8 @@ public function update(Request $request) /** * Clear follow notifications. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return mixed */ public function clearFollowNotifications(Request $request) @@ -118,7 +122,8 @@ public function clearFollowNotifications(Request $request) /** * Get the user notification statistics. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return mixed */ public function statistics(Request $request) diff --git a/app/API2/Controllers/UserCountsController.php b/app/API2/Controllers/UserCountsController.php index 189d927eb..e81219e5b 100644 --- a/app/API2/Controllers/UserCountsController.php +++ b/app/API2/Controllers/UserCountsController.php @@ -41,8 +41,9 @@ public function __construct() /** * The route controller to callable handle. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return \Illuminate\Http\JsonResponse + * * @author Seven Du */ public function count(Request $request): JsonResponse @@ -59,11 +60,13 @@ public function count(Request $request): JsonResponse /** * 重置某项为度数为0. + * * @Author Wayne * @DateTime 2018-04-16 * @Email qiaobin@zhiyicx.com - * @param Request $request [description] - * @return [type] [description] + * + * @param Request $request [description] + * @return [type] [description] */ public function reset(Request $request) { diff --git a/app/API2/Requests/ListAllComments.php b/app/API2/Requests/ListAllComments.php index 17d2295ec..41aa2501b 100644 --- a/app/API2/Requests/ListAllComments.php +++ b/app/API2/Requests/ListAllComments.php @@ -24,6 +24,7 @@ class ListAllComments extends Request { /** * The validate rules. + * * @return array */ public function rules(): array @@ -43,6 +44,7 @@ public function rules(): array /** * Get the validate error messages. + * * @return array */ public function messages(): array diff --git a/app/API2/Requests/User/Message/ListAtMessageLine.php b/app/API2/Requests/User/Message/ListAtMessageLine.php index 9a7cac765..a9180b8fd 100644 --- a/app/API2/Requests/User/Message/ListAtMessageLine.php +++ b/app/API2/Requests/User/Message/ListAtMessageLine.php @@ -26,6 +26,7 @@ class ListAtMessageLine extends Request { /** * Get the validate rules. + * * @return array */ public function rules(): array @@ -40,6 +41,7 @@ public function rules(): array /** * Get the validate error messages. + * * @return array */ public function messages(): array diff --git a/app/API2/Resources/Ability.php b/app/API2/Resources/Ability.php index de24843a1..3e9958666 100644 --- a/app/API2/Resources/Ability.php +++ b/app/API2/Resources/Ability.php @@ -26,7 +26,8 @@ class Ability extends JsonResource { /** * The resource to array. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return array */ public function toArray($request): array diff --git a/app/API2/Resources/Comment.php b/app/API2/Resources/Comment.php index b2967580c..684738bc8 100644 --- a/app/API2/Resources/Comment.php +++ b/app/API2/Resources/Comment.php @@ -30,7 +30,8 @@ class Comment extends JsonResource /** * The resource to array. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return array */ public function toArray($request): array diff --git a/app/API2/Resources/Feed/Topic.php b/app/API2/Resources/Feed/Topic.php index 80f386517..9c5d9ed98 100644 --- a/app/API2/Resources/Feed/Topic.php +++ b/app/API2/Resources/Feed/Topic.php @@ -27,7 +27,7 @@ class Topic extends JsonResource /** * The topic resource to array. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return array */ public function toArray($request): array diff --git a/app/API2/Resources/Feed/TopicParticipantCollection.php b/app/API2/Resources/Feed/TopicParticipantCollection.php index aff863491..e8a47c39a 100644 --- a/app/API2/Resources/Feed/TopicParticipantCollection.php +++ b/app/API2/Resources/Feed/TopicParticipantCollection.php @@ -27,7 +27,7 @@ class TopicParticipantCollection extends ResourceCollection /** * The collection to array. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return array */ public function toArray($request): array @@ -43,7 +43,7 @@ public function toArray($request): array /** * Render the collection item. * - * @param mixed $item + * @param mixed $item * @return int */ public function renderItem($item): int diff --git a/app/API2/Resources/Notification.php b/app/API2/Resources/Notification.php index c48838c3d..27e49726f 100644 --- a/app/API2/Resources/Notification.php +++ b/app/API2/Resources/Notification.php @@ -29,7 +29,8 @@ class Notification extends JsonResource /** * The resource to array. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return array */ public function toArray($request): array diff --git a/app/API2/Resources/User/Message/AtMessage.php b/app/API2/Resources/User/Message/AtMessage.php index a95890f6c..32b6487c7 100644 --- a/app/API2/Resources/User/Message/AtMessage.php +++ b/app/API2/Resources/User/Message/AtMessage.php @@ -30,7 +30,8 @@ class AtMessage extends JsonResource /** * The resource to array. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return array */ public function toArray($request): array diff --git a/app/API2/Resources/UserCountsResource.php b/app/API2/Resources/UserCountsResource.php index 4de455634..8bdece64b 100644 --- a/app/API2/Resources/UserCountsResource.php +++ b/app/API2/Resources/UserCountsResource.php @@ -27,8 +27,9 @@ class UserCountsResource extends JsonResource /** * The resource to array. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return array + * * @author Seven Du */ public function toArray($request): array diff --git a/app/Admin/Controllers/AboutUsController.php b/app/Admin/Controllers/AboutUsController.php index 77f1bb3c4..498086a2b 100644 --- a/app/Admin/Controllers/AboutUsController.php +++ b/app/Admin/Controllers/AboutUsController.php @@ -36,8 +36,8 @@ public function show(): JsonResponse } /** - * @param Request $request - * @param Configuration $config + * @param Request $request + * @param Configuration $config * @return Response */ public function store(Request $request, Configuration $config): Response diff --git a/app/Admin/Controllers/FileStorage/AliyunOSSFilesystem.php b/app/Admin/Controllers/FileStorage/AliyunOSSFilesystem.php index 2d187b8ce..d98e11732 100644 --- a/app/Admin/Controllers/FileStorage/AliyunOSSFilesystem.php +++ b/app/Admin/Controllers/FileStorage/AliyunOSSFilesystem.php @@ -29,6 +29,7 @@ class AliyunOSSFilesystem { /** * Get Aliyun OSS filesystem. + * * @return \Illuminate\Http\JsonResponse */ public function show(): JsonResponse @@ -49,7 +50,8 @@ public function show(): JsonResponse /** * Update Aliyun OSS filesystem. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return \Illuminate\Http\Response */ public function update(Request $request): Response diff --git a/app/Admin/Controllers/FileStorage/DefaultFilesystem.php b/app/Admin/Controllers/FileStorage/DefaultFilesystem.php index b886b0c6e..903a92f2f 100644 --- a/app/Admin/Controllers/FileStorage/DefaultFilesystem.php +++ b/app/Admin/Controllers/FileStorage/DefaultFilesystem.php @@ -30,6 +30,7 @@ class DefaultFilesystem { /** * Get default filesystem. + * * @return \Illuminate\Http\JsonResponse */ public function show(): JsonResponse @@ -41,7 +42,8 @@ public function show(): JsonResponse /** * Update default filesystem. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return \Illuminate\Http\Response */ public function update(Request $request): Response diff --git a/app/Admin/Controllers/FileStorage/FileSize.php b/app/Admin/Controllers/FileStorage/FileSize.php index a274a8599..435546fb5 100644 --- a/app/Admin/Controllers/FileStorage/FileSize.php +++ b/app/Admin/Controllers/FileStorage/FileSize.php @@ -30,6 +30,7 @@ class FileSize { /** * Get file storage validate size. + * * @return \Illuminate\Http\JsonResponse */ public function show(): JsonResponse @@ -51,7 +52,8 @@ public function show(): JsonResponse /** * Update file storage validate file size. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return \Illuminate\Http\Response */ public function update(Request $request): Response diff --git a/app/Admin/Controllers/FileStorage/ImageDimension.php b/app/Admin/Controllers/FileStorage/ImageDimension.php index f58cba889..39c6db5c2 100644 --- a/app/Admin/Controllers/FileStorage/ImageDimension.php +++ b/app/Admin/Controllers/FileStorage/ImageDimension.php @@ -29,6 +29,7 @@ class ImageDimension { /** * Show file storage validate image dimension. + * * @return \Illuminate\Http\JsonResponse */ public function show(): JsonResponse @@ -58,7 +59,8 @@ public function show(): JsonResponse /** * Update file storage validate image dimension. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return \Illuminate\Http\Response */ public function update(Request $request): Response diff --git a/app/Admin/Controllers/FileStorage/LocalFilesystem.php b/app/Admin/Controllers/FileStorage/LocalFilesystem.php index 2f0fe0f41..8e90fe660 100644 --- a/app/Admin/Controllers/FileStorage/LocalFilesystem.php +++ b/app/Admin/Controllers/FileStorage/LocalFilesystem.php @@ -30,6 +30,7 @@ class LocalFilesystem { /** * Get local filesystem. + * * @return \Illuminate\Http\JsonResponse */ public function show(): JsonResponse @@ -46,7 +47,8 @@ public function show(): JsonResponse /** * Update local filesystem. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return \Illuminate\Http\Response */ public function update(Request $request): Response diff --git a/app/Admin/Controllers/FileStorage/MimeType.php b/app/Admin/Controllers/FileStorage/MimeType.php index c9ece96e0..cab108fc1 100644 --- a/app/Admin/Controllers/FileStorage/MimeType.php +++ b/app/Admin/Controllers/FileStorage/MimeType.php @@ -31,6 +31,7 @@ class MimeType { /** * Caching MIME types. + * * @var array */ protected $mimeTypes; @@ -45,6 +46,7 @@ public function __construct() /** * Get file storage validate MIME types. + * * @return \Illuminate\Http\JsonResponse */ public function show(): JsonResponse @@ -63,8 +65,10 @@ public function show(): JsonResponse /** * Update file storage validate MIME types. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return \Illuminate\Http\Response + * * @throws \Throwable */ public function update(Request $request): Response diff --git a/app/Admin/Controllers/FileStorage/PublicChannel.php b/app/Admin/Controllers/FileStorage/PublicChannel.php index f91b7522d..1ea2f1ee3 100644 --- a/app/Admin/Controllers/FileStorage/PublicChannel.php +++ b/app/Admin/Controllers/FileStorage/PublicChannel.php @@ -30,6 +30,7 @@ class PublicChannel { /** * Get public channel settings. + * * @return \Illuminate\Http\JsonResponse */ public function show(): JsonResponse @@ -44,7 +45,8 @@ public function show(): JsonResponse /** * Update public channel settings. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return \Illuminate\Http\Response */ public function update(Request $request): Response diff --git a/app/Admin/Controllers/ImHelperUserController.php b/app/Admin/Controllers/ImHelperUserController.php index 780bae5f5..d69df472f 100644 --- a/app/Admin/Controllers/ImHelperUserController.php +++ b/app/Admin/Controllers/ImHelperUserController.php @@ -32,6 +32,7 @@ class ImHelperUserController extends Controller * Fetch im helper user id. * * @return \Illuminate\Http\JsonResponse + * * @author Seven Du */ public function fetch(): JsonResponse @@ -42,9 +43,10 @@ public function fetch(): JsonResponse /** * Update im helper user id. * - * @param \Zhiyi\Plus\Admin\Requests\UpdateImHelperUserRequest $request - * @param \Zhiyi\Plus\Support\Configuration $config + * @param \Zhiyi\Plus\Admin\Requests\UpdateImHelperUserRequest $request + * @param \Zhiyi\Plus\Support\Configuration $config * @return \Illuminate\Http\Response + * * @author Seven Du */ // public function update(UpdateImHelperUserRequest $request, Configuration $config): Response diff --git a/app/Admin/Controllers/Setting/Easemob.php b/app/Admin/Controllers/Setting/Easemob.php index ea4875eb6..d099de262 100644 --- a/app/Admin/Controllers/Setting/Easemob.php +++ b/app/Admin/Controllers/Setting/Easemob.php @@ -30,6 +30,7 @@ class Easemob extends Controller { /** * Get configure. + * * @return \Illuminate\Http\JsonResponse */ public function getConfigure(): JsonResponse @@ -47,7 +48,8 @@ public function getConfigure(): JsonResponse /** * set configure. - * @param \Zhiyi\Plus\Admin\Requests\SetEasemob $request + * + * @param \Zhiyi\Plus\Admin\Requests\SetEasemob $request * @return \Illuminate\Http\Response */ public function setConfigure(SetEasemobRequest $request) diff --git a/app/Admin/Controllers/Setting/QQ.php b/app/Admin/Controllers/Setting/QQ.php index 6dbec924d..1c209687f 100644 --- a/app/Admin/Controllers/Setting/QQ.php +++ b/app/Admin/Controllers/Setting/QQ.php @@ -30,6 +30,7 @@ class QQ extends Controller { /** * Get configure. + * * @return \Illuminate\Http\JsonResponse */ public function getConfigure(): JsonResponse @@ -44,7 +45,8 @@ public function getConfigure(): JsonResponse /** * set configure. - * @param \Zhiyi\Plus\Admin\Requests\SetQQConfigure $request + * + * @param \Zhiyi\Plus\Admin\Requests\SetQQConfigure $request * @return \Illuminate\Http\Response */ public function setConfigure(SetQQConfigureRequest $request) diff --git a/app/Admin/Controllers/Setting/Security.php b/app/Admin/Controllers/Setting/Security.php index d29ac275b..def0681a3 100644 --- a/app/Admin/Controllers/Setting/Security.php +++ b/app/Admin/Controllers/Setting/Security.php @@ -30,6 +30,7 @@ class Security extends Controller { /** * Get pay validate password switch. + * * @return \Illuminate\Http\JsonResponse */ public function payValidateSwitch(): JsonResponse @@ -41,7 +42,8 @@ public function payValidateSwitch(): JsonResponse /** * Change pay validate password switch. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return \Illuminate\Http\Response */ public function changePayValidateSwitch(Request $request): Response diff --git a/app/Admin/Controllers/Setting/WeChat.php b/app/Admin/Controllers/Setting/WeChat.php index 62b44baeb..3d8afb715 100644 --- a/app/Admin/Controllers/Setting/WeChat.php +++ b/app/Admin/Controllers/Setting/WeChat.php @@ -30,6 +30,7 @@ class WeChat extends Controller { /** * Get configure. + * * @return \Illuminate\Http\JsonResponse */ public function getConfigure(): JsonResponse @@ -44,7 +45,8 @@ public function getConfigure(): JsonResponse /** * set configure. - * @param \Zhiyi\Plus\Admin\Requests\SetWeChatConfigureRequest $request + * + * @param \Zhiyi\Plus\Admin\Requests\SetWeChatConfigureRequest $request * @return \Illuminate\Http\Response */ public function setConfigure(SetWeChatConfigureRequest $request) diff --git a/app/Admin/Controllers/Setting/WeChatMp.php b/app/Admin/Controllers/Setting/WeChatMp.php index 0e8d415e8..53f982209 100644 --- a/app/Admin/Controllers/Setting/WeChatMp.php +++ b/app/Admin/Controllers/Setting/WeChatMp.php @@ -30,6 +30,7 @@ class WeChatMp extends Controller { /** * Get configure. + * * @return \Illuminate\Http\JsonResponse */ public function getConfigure(): JsonResponse @@ -44,7 +45,8 @@ public function getConfigure(): JsonResponse /** * set configure. - * @param \Zhiyi\Plus\Admin\Requests\SetWeChatMpConfigure $request + * + * @param \Zhiyi\Plus\Admin\Requests\SetWeChatMpConfigure $request * @return \Illuminate\Http\Response */ public function setConfigure(SetWeChatMpConfigureRequest $request) diff --git a/app/Admin/Controllers/Setting/Weibo.php b/app/Admin/Controllers/Setting/Weibo.php index 93e578750..263123d43 100644 --- a/app/Admin/Controllers/Setting/Weibo.php +++ b/app/Admin/Controllers/Setting/Weibo.php @@ -30,6 +30,7 @@ class Weibo extends Controller { /** * Get configure. + * * @return \Illuminate\Http\JsonResponse */ public function getConfigure(): JsonResponse @@ -44,7 +45,8 @@ public function getConfigure(): JsonResponse /** * set configure. - * @param \Zhiyi\Plus\Admin\Requests\SetWeiboConfigureRequest $request + * + * @param \Zhiyi\Plus\Admin\Requests\SetWeiboConfigureRequest $request * @return \Illuminate\Http\Response */ public function setConfigure(SetWeiboConfigureRequest $request) diff --git a/app/Admin/Controllers/UserTrashedController.php b/app/Admin/Controllers/UserTrashedController.php index ea4e63e94..808e77aa0 100644 --- a/app/Admin/Controllers/UserTrashedController.php +++ b/app/Admin/Controllers/UserTrashedController.php @@ -29,8 +29,9 @@ class UserTrashedController extends Controller /** * List trashed users. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return mixed + * * @author Seven Du */ public function index(Request $request) @@ -52,8 +53,9 @@ public function index(Request $request) /** * Restore a trashed user. * - * @param int $user + * @param int $user * @return mixed + * * @author Seven Du */ public function restore(int $user) diff --git a/app/Admin/Requests/SetEasemob.php b/app/Admin/Requests/SetEasemob.php index 0ba78c234..178f4981b 100644 --- a/app/Admin/Requests/SetEasemob.php +++ b/app/Admin/Requests/SetEasemob.php @@ -28,6 +28,7 @@ class SetEasemob extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array @@ -56,6 +58,7 @@ public function rules(): array * Get the validation message that apply to the request. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/app/Admin/Requests/SetQQConfigure.php b/app/Admin/Requests/SetQQConfigure.php index 8ef9438d4..fe49848a5 100644 --- a/app/Admin/Requests/SetQQConfigure.php +++ b/app/Admin/Requests/SetQQConfigure.php @@ -28,6 +28,7 @@ class SetQQConfigure extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/app/Admin/Requests/SetWeChatConfigure.php b/app/Admin/Requests/SetWeChatConfigure.php index abaabe92b..c28c22078 100644 --- a/app/Admin/Requests/SetWeChatConfigure.php +++ b/app/Admin/Requests/SetWeChatConfigure.php @@ -28,6 +28,7 @@ class SetWeChatConfigure extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/app/Admin/Requests/SetWeChatMpConfigure.php b/app/Admin/Requests/SetWeChatMpConfigure.php index 320442439..cb50a6943 100644 --- a/app/Admin/Requests/SetWeChatMpConfigure.php +++ b/app/Admin/Requests/SetWeChatMpConfigure.php @@ -28,6 +28,7 @@ class SetWeChatMpConfigure extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/app/Admin/Requests/SetWeiboConfigure.php b/app/Admin/Requests/SetWeiboConfigure.php index eb99a1d15..aa0cc6b5c 100644 --- a/app/Admin/Requests/SetWeiboConfigure.php +++ b/app/Admin/Requests/SetWeiboConfigure.php @@ -28,6 +28,7 @@ class SetWeiboConfigure extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/app/Admin/Requests/UpdateImHelperUserRequest.php b/app/Admin/Requests/UpdateImHelperUserRequest.php index b6eec408d..b289702dc 100644 --- a/app/Admin/Requests/UpdateImHelperUserRequest.php +++ b/app/Admin/Requests/UpdateImHelperUserRequest.php @@ -28,6 +28,7 @@ class UpdateImHelperUserRequest extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array @@ -52,6 +54,7 @@ public function rules(): array * Get the validation message that apply to the request. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/app/Admin/Resources/TrashedUserResource.php b/app/Admin/Resources/TrashedUserResource.php index 3f960a623..89d35c15d 100644 --- a/app/Admin/Resources/TrashedUserResource.php +++ b/app/Admin/Resources/TrashedUserResource.php @@ -28,8 +28,9 @@ class TrashedUserResource extends JsonResource /** * The resource to array handle. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return array + * * @author Seven Du */ public function toArray($request): array diff --git a/app/Application.php b/app/Application.php index aa0d14a74..68f8e6873 100644 --- a/app/Application.php +++ b/app/Application.php @@ -34,7 +34,8 @@ class Application extends LaravelApplication implements AppInterface /** * Create a new Illuminate application instance. * - * @param string|null $basePath + * @param string|null $basePath + * * @author Seven Du */ public function __construct($basePath = null) @@ -55,6 +56,7 @@ public function __construct($basePath = null) * Get the version number of the Laravel framework. * * @return string + * * @author Seven Du */ public function getLaravelVersion() @@ -99,7 +101,8 @@ public function registerCoreContainerAliases() /** * The app configure path. - * @param string $path + * + * @param string $path * @return string */ public function appConfigurePath(string $path = ''): string @@ -109,6 +112,7 @@ public function appConfigurePath(string $path = ''): string /** * Get the app YAML configure filename. + * * @return string */ public function appYamlConfigureFile(): string diff --git a/app/AtMessage/AtMessageHelperTrait.php b/app/AtMessage/AtMessageHelperTrait.php index 70e677be4..94c639343 100644 --- a/app/AtMessage/AtMessageHelperTrait.php +++ b/app/AtMessage/AtMessageHelperTrait.php @@ -26,9 +26,10 @@ trait AtMessageHelperTrait { /** * Send at message. - * @param string $content - * @param \Zhiyi\Plus\Models\User $sender - * @param mixed $resource + * + * @param string $content + * @param \Zhiyi\Plus\Models\User $sender + * @param mixed $resource * @return void */ public function sendAtMessage(string $content, UserModel $sender, $resource): void diff --git a/app/AtMessage/Message.php b/app/AtMessage/Message.php index 3b39c4b46..c56d1f763 100644 --- a/app/AtMessage/Message.php +++ b/app/AtMessage/Message.php @@ -27,13 +27,15 @@ class Message implements MessageInterface { /** * Resources manager. + * * @var \Zhiyi\Plus\AtMessage\ResourceManagerInterface */ protected $manager; /** * Create the message instance. - * @param \Zhiyi\Plus\AtMessage\ResourceManagerInterface $manager + * + * @param \Zhiyi\Plus\AtMessage\ResourceManagerInterface $manager */ public function __construct(ResourceManagerInterface $manager) { @@ -42,9 +44,10 @@ public function __construct(ResourceManagerInterface $manager) /** * The message send handler. - * @param \Zhiyi\Plus\Models\User $sender - * @param \Zhiyi\Plus\Models\User $user - * @param mixed $resource + * + * @param \Zhiyi\Plus\Models\User $sender + * @param \Zhiyi\Plus\Models\User $user + * @param mixed $resource * @return void */ public function send(UserModel $sender, UserModel $user, $resource): void diff --git a/app/AtMessage/MessageInterface.php b/app/AtMessage/MessageInterface.php index 683015b46..3bb27c9f4 100644 --- a/app/AtMessage/MessageInterface.php +++ b/app/AtMessage/MessageInterface.php @@ -26,9 +26,10 @@ interface MessageInterface { /** * Send at message. - * @param \Zhiyi\Plus\Models\User $sender - * @param \Zhiyi\Plus\Models\User $user - * @param mixed $resource + * + * @param \Zhiyi\Plus\Models\User $sender + * @param \Zhiyi\Plus\Models\User $user + * @param mixed $resource * @return void */ public function send(UserModel $sender, UserModel $user, $resource): void; diff --git a/app/AtMessage/ResourceInterface.php b/app/AtMessage/ResourceInterface.php index b6f29c670..a5f9f8356 100644 --- a/app/AtMessage/ResourceInterface.php +++ b/app/AtMessage/ResourceInterface.php @@ -24,18 +24,21 @@ interface ResourceInterface { /** * Get the resourceable type. + * * @return string */ public function type(): string; /** * Get the resourceable id. + * * @return int */ public function id(): int; /** * Get the resource push message. + * * @return string */ public function message(): string; diff --git a/app/AtMessage/ResourceManager.php b/app/AtMessage/ResourceManager.php index 1805f051a..8ae7b877e 100644 --- a/app/AtMessage/ResourceManager.php +++ b/app/AtMessage/ResourceManager.php @@ -27,6 +27,7 @@ class ResourceManager implements ResourceManagerInterface { /** * Resource map. + * * @var array */ public static $map = [ @@ -36,9 +37,11 @@ class ResourceManager implements ResourceManagerInterface /** * Get resource. - * @param mixed $resource - * @param \Zhiyi\Plus\Models\User $sender + * + * @param mixed $resource + * @param \Zhiyi\Plus\Models\User $sender * @return \Zhiyi\Plus\AtMessage\ResourceInterface + * * @throws \InvalidArgumentException */ public function resource($resource, UserModel $sender): ResourceInterface @@ -56,7 +59,8 @@ public function resource($resource, UserModel $sender): ResourceInterface /** * Get resource class name. - * @param mixed $resource + * + * @param mixed $resource * @return string */ public function getClassName($resource): string diff --git a/app/AtMessage/ResourceManagerInterface.php b/app/AtMessage/ResourceManagerInterface.php index 5d0c0dce4..92d570697 100644 --- a/app/AtMessage/ResourceManagerInterface.php +++ b/app/AtMessage/ResourceManagerInterface.php @@ -26,15 +26,17 @@ interface ResourceManagerInterface { /** * Get resource. - * @param mixed $resource - * @param \Zhiyi\Plus\Models\User $sender + * + * @param mixed $resource + * @param \Zhiyi\Plus\Models\User $sender * @return \Zhiyi\Plus\AtMessage\ResourceInterface */ public function resource($resource, UserModel $sender): ResourceInterface; /** * Get resource class name. - * @param mixed $resource + * + * @param mixed $resource * @return string */ public function getClassName($resource): string; diff --git a/app/AtMessage/Resources/Comment.php b/app/AtMessage/Resources/Comment.php index 71a294f0a..fecdb1968 100644 --- a/app/AtMessage/Resources/Comment.php +++ b/app/AtMessage/Resources/Comment.php @@ -29,20 +29,23 @@ class Comment implements ResourceInterface { /** * The comment resource. + * * @var \Zhiyi\Plus\Models\Comment */ protected $comment; /** * The sender. + * * @var \Zhiyi\Plus\Models\User */ protected $sender; /** * Create the resource. - * @param \Zhiyi\Plus\Models\Comment $comment - * @param \Zhiyi\Plus\Models\User $sender + * + * @param \Zhiyi\Plus\Models\Comment $comment + * @param \Zhiyi\Plus\Models\User $sender */ public function __construct(CommentModel $comment, UserModel $sender) { @@ -52,6 +55,7 @@ public function __construct(CommentModel $comment, UserModel $sender) /** * Get the resourceable type. + * * @return string */ public function type(): string @@ -67,6 +71,7 @@ public function type(): string /** * Get the resourceable id. + * * @return int */ public function id(): int @@ -76,6 +81,7 @@ public function id(): int /** * Get the resourceable push message. + * * @return string */ public function message(): string diff --git a/app/AtMessage/Resources/Feed.php b/app/AtMessage/Resources/Feed.php index f4c5b3018..7a6f6c891 100644 --- a/app/AtMessage/Resources/Feed.php +++ b/app/AtMessage/Resources/Feed.php @@ -30,20 +30,23 @@ class Feed implements ResourceInterface { /** * The feed resource. + * * @var \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed */ protected $feed; /** * Sender resource. + * * @var \Zhiyi\Plus\Models\User */ protected $sender; /** * Create a feed resource. - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed - * @param \Zhiyi\Plus\Models\User $sender + * + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Zhiyi\Plus\Models\User $sender */ public function __construct(FeedModel $feed, UserModel $sender) { @@ -53,6 +56,7 @@ public function __construct(FeedModel $feed, UserModel $sender) /** * Get the resourceable type. + * * @return string */ public function type(): string @@ -68,6 +72,7 @@ public function type(): string /** * Get the resourceable id. + * * @return int */ public function id(): int @@ -77,6 +82,7 @@ public function id(): int /** * Get the pusher message. + * * @return string */ public function message(): string diff --git a/app/Auth/JWTAuthToken.php b/app/Auth/JWTAuthToken.php index 32977a7a3..690c951e1 100644 --- a/app/Auth/JWTAuthToken.php +++ b/app/Auth/JWTAuthToken.php @@ -35,7 +35,8 @@ class JWTAuthToken /** * Create the JWTAuthToken instance. * - * @param \Tymon\JWTAuth\JWT $jwt + * @param \Tymon\JWTAuth\JWT $jwt + * * @author Seven Du */ public function __construct(JWT $jwt) @@ -46,8 +47,9 @@ public function __construct(JWT $jwt) /** * Create user token. * - * @param UserModel $user + * @param UserModel $user * @return mixed + * * @author Seven Du */ public function create(UserModel $user) @@ -58,8 +60,9 @@ public function create(UserModel $user) /** * Refresh token. * - * @param string $token + * @param string $token * @return mixed + * * @author Seven Du */ public function refresh(string $token) diff --git a/app/Bootstrap/LoadConfiguration.php b/app/Bootstrap/LoadConfiguration.php index 6e2871e28..5378d45b7 100644 --- a/app/Bootstrap/LoadConfiguration.php +++ b/app/Bootstrap/LoadConfiguration.php @@ -43,6 +43,7 @@ public function __construct(Application $app, Configuration $configuration) * Run handler. * * @return void + * * @author Seven Du */ public function handle() diff --git a/app/Cdn/Adapter/AliOss.php b/app/Cdn/Adapter/AliOss.php index e8ad0c5c6..5b74fcce7 100644 --- a/app/Cdn/Adapter/AliOss.php +++ b/app/Cdn/Adapter/AliOss.php @@ -70,8 +70,8 @@ public function __construct() * * @param string $filename * @param array $extra - * * @return string + * * @author Seven Du */ public function url(string $filename, array $extra = []): string @@ -91,8 +91,8 @@ public function url(string $filename, array $extra = []): string * Refresh the cdn files and dirs. * * @param \Zhiyi\Plus\Cdn\Refresh $refresh - * * @return void + * * @author Seven Du */ public function refresh(Refresh $refresh) @@ -123,8 +123,8 @@ public function refresh(Refresh $refresh) * * @param string $filename * @param array $extra - * * @return string + * * @author BS <414606094@qq.com> */ protected function makeSignURL(string $filename, array $extra): string @@ -143,8 +143,8 @@ protected function makeSignURL(string $filename, array $extra): string * * @param string $filename * @param array $extra - * * @return string + * * @author Seven Du */ protected function makePublicURL(string $filename, array $extra): string @@ -160,8 +160,8 @@ protected function makePublicURL(string $filename, array $extra): string * * @param string $filename * @param array $extra - * * @return array + * * @author BS <414606094@qq.com> */ protected function getProcess(string $filename, array $extra): array @@ -219,8 +219,8 @@ protected function getProcess(string $filename, array $extra): array * Check file not image file. * * @param string $filename - * * @return bool + * * @author Seven Du */ protected function isImage(string $filename): bool @@ -234,9 +234,10 @@ protected function isImage(string $filename): bool * * @param string $url * @param array $query - * * @return string + * * @throws \Exception + * * @author Seven Du */ protected function resolveQueryString(string $url, array $query = []): string @@ -262,8 +263,8 @@ protected function resolveQueryString(string $url, array $query = []): string * * @param string $query1 [description] * @param string $query2 [description] - * * @return [type] [description] + * * @author Seven Du */ protected function mergeHttpQueryString( @@ -285,8 +286,8 @@ protected function mergeHttpQueryString( * Filter the slash. * * @param string $filename - * * @return string + * * @author Seven Du */ protected function filterSlash(string $filename): string @@ -311,8 +312,8 @@ protected function filterSlash(string $filename): string * If not $endpoint param, Use $this->endpoint * * @param string $endpoint - * * @return string + * * @author Seven Du */ protected function getBaseURI(string $endpoint = ''): string @@ -335,6 +336,7 @@ protected function getBaseURI(string $endpoint = ''): string * Get scheme. * * @return string + * * @author Seven Du */ protected function getScheme(): string diff --git a/app/Cdn/Adapter/Filesystem.php b/app/Cdn/Adapter/Filesystem.php index 6fd071bcc..24facd91f 100644 --- a/app/Cdn/Adapter/Filesystem.php +++ b/app/Cdn/Adapter/Filesystem.php @@ -54,7 +54,8 @@ class Filesystem implements FileUrlGeneratorContract /** * Create the CDN generator. * - * @param \Illuminate\Contracts\Foundation\Application $app + * @param \Illuminate\Contracts\Foundation\Application $app + * * @author Seven Du */ public function __construct(ApplicationContract $app, FilesystemFactoryContract $files) @@ -68,10 +69,12 @@ public function __construct(ApplicationContract $app, FilesystemFactoryContract /** * Generator a URL. * - * @param string $filename - * @param array $extra - * @throws \Exception + * @param string $filename + * @param array $extra * @return string + * + * @throws \Exception + * * @author Seven Du */ public function url(string $filename, array $extra = []): string @@ -106,8 +109,9 @@ public function url(string $filename, array $extra = []): string /** * Refresh the cdn files and dirs. * - * @param \Zhiyi\Plus\Cdn\Refresh $refresh + * @param \Zhiyi\Plus\Cdn\Refresh $refresh * @return void + * * @author Seven Du */ public function refresh(Refresh $refresh) @@ -123,9 +127,10 @@ public function refresh(Refresh $refresh) /** * 保存转换后的文件并返回地址. * - * @param \Intervention\Image\Image $image - * @param string $filename + * @param \Intervention\Image\Image $image + * @param string $filename * @return string + * * @author Seven Du */ private function putProcessFile(Image $image, string $filename): string @@ -140,9 +145,10 @@ private function putProcessFile(Image $image, string $filename): string /** * 处理文件尺寸. * - * @param \Intervention\Image\Image $image - * @param array $extra + * @param \Intervention\Image\Image $image + * @param array $extra * @return void + * * @author Seven Du */ protected function processSize(Image $image, array $extra) @@ -173,10 +179,11 @@ protected function processSize(Image $image, array $extra) /** * 验证文件是否需要处理，如果需要则执行回调. * - * @param string $filename - * @param array $extra - * @param callable $call + * @param string $filename + * @param array $extra + * @param callable $call * @return string + * * @author Seven Du */ private function validateProcessAnd(string $filename, array $extra, callable $call): string @@ -201,10 +208,11 @@ private function validateProcessAnd(string $filename, array $extra, callable $ca /** * 验证文件指纹，如果指纹文件存在，则直接返回，否则执行回调. * - * @param string $filename - * @param callable $call - * @param array $extra + * @param string $filename + * @param callable $call + * @param array $extra * @return string + * * @author Seven Du */ private function validateFingerprint(string $filename, callable $call, array $extra): string @@ -224,8 +232,9 @@ private function validateFingerprint(string $filename, callable $call, array $ex /** * Make Image. * - * @param string $filename + * @param string $filename * @return \Intervention\Image\Image + * * @author Seven Du */ protected function makeImage(string $filename): Image @@ -236,8 +245,9 @@ protected function makeImage(string $filename): Image /** * 生成文件转换信息指纹. * - * @param array $extra + * @param array $extra * @return string + * * @author Seven Du */ protected function makeProcessFingerprint(array $extra): string @@ -248,9 +258,10 @@ protected function makeProcessFingerprint(array $extra): string /** * 生成转换后的文件路径. * - * @param string $filename - * @param string $fingerprint + * @param string $filename + * @param string $fingerprint * @return string + * * @author Seven Du */ protected function makeProcessFilename(string $filename, string $fingerprint): string @@ -264,6 +275,7 @@ protected function makeProcessFilename(string $filename, string $fingerprint): s * 获取支持的文件 mimeType. * * @return array + * * @author Seven Du */ public function getSupportMimeTypes(): array @@ -289,9 +301,10 @@ public function getSupportMimeTypes(): array /** * 验证是否是图片，如果是并且执行回调. * - * @param string $filename - * @param callable $call + * @param string $filename + * @param callable $call * @return string + * * @author Seven Du */ private function validateImageAnd(string $filename, callable $call): string @@ -306,8 +319,9 @@ private function validateImageAnd(string $filename, callable $call): string /** * Make public URL. * - * @param string $filename + * @param string $filename * @return string + * * @author Seven Du */ protected function makeUrl(string $filename): string diff --git a/app/Cdn/Adapter/Qiniu.php b/app/Cdn/Adapter/Qiniu.php index 807a1753d..13a9a2ad4 100644 --- a/app/Cdn/Adapter/Qiniu.php +++ b/app/Cdn/Adapter/Qiniu.php @@ -77,9 +77,10 @@ public function __construct() /** * Build the filename url. * - * @param string $filename - * @param array $extra + * @param string $filename + * @param array $extra * @return string + * * @author Seven Du */ public function url(string $filename, array $extra = []): string @@ -94,8 +95,9 @@ public function url(string $filename, array $extra = []): string /** * Refresh the cdn files and dirs. * - * @param \Zhiyi\Plus\Cdn\Refresh $refresh + * @param \Zhiyi\Plus\Cdn\Refresh $refresh * @return void + * * @author Seven Du */ public function refresh(Refresh $refresh) @@ -110,8 +112,9 @@ public function refresh(Refresh $refresh) /** * 刷新 融合 CDN. * - * @param \Zhiyi\Plus\Cdn\Refresh $refresh + * @param \Zhiyi\Plus\Cdn\Refresh $refresh * @return void + * * @author Seven Du */ protected function refreshByCdn(Refresh $refresh) @@ -151,8 +154,9 @@ protected function refreshByCdn(Refresh $refresh) /** * 删除 Qiniu Object Storage. * - * @param \Zhiyi\Plus\Cdn\Refresh $refresh + * @param \Zhiyi\Plus\Cdn\Refresh $refresh * @return void + * * @author Seven Du */ protected function refreshByObject(Refresh $refresh) @@ -198,10 +202,11 @@ protected function refreshByObject(Refresh $refresh) /** * Make the filename type. * - * @param string $filename - * @param array $extra - * @param bool $image + * @param string $filename + * @param array $extra + * @param bool $image * @return string + * * @author Seven Du */ private function make(string $filename, array $extra = [], $image = false): string @@ -216,8 +221,9 @@ private function make(string $filename, array $extra = [], $image = false): stri /** * Build file url. * - * @param string $filename + * @param string $filename * @return string + * * @author Seven Du */ private function makeFile(string $filename): string @@ -230,9 +236,10 @@ private function makeFile(string $filename): string /** * Build image url. * - * @param string $filename - * @param array $extra + * @param string $filename + * @param array $extra * @return string + * * @author Seven Du */ private function makeImage(string $filename, array $extra = []): string @@ -250,8 +257,9 @@ private function makeImage(string $filename, array $extra = []): string /** * Make the private resource token. * - * @param string $url + * @param string $url * @return string + * * @author Seven Du */ private function makeToken(string $url): string @@ -284,11 +292,12 @@ protected function safeBase64Encode(string $data): string /** * Build the image processor. * - * @param int $width - * @param int $height - * @param int $quality - * @param int $blur + * @param int $width + * @param int $height + * @param int $quality + * @param int $blur * @return string + * * @author Seven Du */ private function makeImageProcessor(int $width, int $height, int $quality, int $blur): string @@ -299,9 +308,10 @@ private function makeImageProcessor(int $width, int $height, int $quality, int $ /** * Validate is image. * - * @param string $filename - * @param callable $call + * @param string $filename + * @param callable $call * @return string + * * @author Seven Du */ private function validateImageAnd(string $filename, callable $call): string @@ -318,6 +328,7 @@ private function validateImageAnd(string $filename, callable $call): string * Get support make file extension. * * @return array + * * @author Seven Du */ private function getSupportExtensions(): array diff --git a/app/Cdn/Refresh.php b/app/Cdn/Refresh.php index 9ee8de4c5..0aea47743 100644 --- a/app/Cdn/Refresh.php +++ b/app/Cdn/Refresh.php @@ -39,8 +39,9 @@ class Refresh /** * Create the refresh. * - * @param array $files - * @param array $dirs + * @param array $files + * @param array $dirs + * * @author Seven Du */ public function __construct(array $files = [], array $dirs = []) @@ -53,6 +54,7 @@ public function __construct(array $files = [], array $dirs = []) * Get files. * * @return array + * * @author Seven Du */ public function getFiles(): array @@ -63,7 +65,8 @@ public function getFiles(): array /** * Set files. * - * @param array $files + * @param array $files + * * @author Seven Du */ public function setFiles(array $files) @@ -77,6 +80,7 @@ public function setFiles(array $files) * Get dirs. * * @return array + * * @author Seven Du */ public function getDirs(): array @@ -87,7 +91,8 @@ public function getDirs(): array /** * Set dirs. * - * @param array $dirs + * @param array $dirs + * * @author Seven Du */ public function setDirs(array $dirs) diff --git a/app/Cdn/UrlManager.php b/app/Cdn/UrlManager.php index b487c8345..645a4a2f9 100644 --- a/app/Cdn/UrlManager.php +++ b/app/Cdn/UrlManager.php @@ -45,7 +45,8 @@ class UrlManager implements UrlFactoryContract /** * Create a file URL generator manager instance. * - * @param \Illuminate\Contracts\Foundation\Application $app + * @param \Illuminate\Contracts\Foundation\Application $app + * * @author Seven Du */ public function __construct(ApplicationContract $app) @@ -56,8 +57,9 @@ public function __construct(ApplicationContract $app) /** * Get URL generator. * - * @param string $driver + * @param string $driver * @return \Zhiyi\Plus\Contracts\Cdn\UrlGenerator + * * @author Seven Du */ public function generator(string $driver = ''): UrlGeneratorContract @@ -70,10 +72,11 @@ public function generator(string $driver = ''): UrlGeneratorContract /** * Make a file url. * - * @param \Zhiyi\Plus\Models\File $file - * @param array $extra - * @param string $driver + * @param \Zhiyi\Plus\Models\File $file + * @param array $extra + * @param string $driver * @return string + * * @author Seven Du */ public function make(File $file, array $extra = [], string $driver = ''): string @@ -90,8 +93,9 @@ public function make(File $file, array $extra = [], string $driver = ''): string /** * Resolve the given generator. * - * @param string $driver + * @param string $driver * @return \Zhiyi\Plus\Contracts\Cdn\UrlGenerator + * * @author Seven Du */ protected function resolve(string $driver): UrlGeneratorContract @@ -104,8 +108,9 @@ protected function resolve(string $driver): UrlGeneratorContract /** * Get a generator abstract. * - * @param string $driver + * @param string $driver * @return string + * * @author Seven Du */ protected function getGeneratorAbstract(string $driver): string @@ -119,6 +124,7 @@ protected function getGeneratorAbstract(string $driver): string * Get default file URL generator. * * @return string + * * @author Seven Du */ protected function getDefaulrGennerator(): string diff --git a/app/Concerns/FindMarkdownFileTrait.php b/app/Concerns/FindMarkdownFileTrait.php index 9a4994559..697ab5c9b 100644 --- a/app/Concerns/FindMarkdownFileTrait.php +++ b/app/Concerns/FindMarkdownFileTrait.php @@ -30,8 +30,9 @@ trait FindMarkdownFileTrait /** * Find markdown image IDs. * - * @param string $markdown + * @param string $markdown * @return array + * * @author Seven Du */ public function findMarkdownImageIDs(string $markdown): array @@ -42,9 +43,10 @@ public function findMarkdownImageIDs(string $markdown): array /** * Find markdown images of collection. * - * @param string $markdown - * @param callable $call + * @param string $markdown + * @param callable $call * @return \Illuminate\Support\Collection + * * @author Seven Du */ public function findMarkdownImageModels(string $markdown, $call = null): Collection @@ -65,8 +67,9 @@ public function findMarkdownImageModels(string $markdown, $call = null): Collect /** * Find markdown images of collection for not with. * - * @param string $markdown + * @param string $markdown * @return \Illuminate\Support\Collection + * * @author Seven Du */ public function findMarkdownImageNotWithModels(string $markdown): Collection diff --git a/app/Console/Commands/AppVersionCommand.php b/app/Console/Commands/AppVersionCommand.php index 2e2e092eb..418759577 100644 --- a/app/Console/Commands/AppVersionCommand.php +++ b/app/Console/Commands/AppVersionCommand.php @@ -50,6 +50,7 @@ class AppVersionCommand extends Command * The console command handle. * * @return mixed + * * @author Seven Du */ public function handle() @@ -74,7 +75,8 @@ public function handle() /** * Set version to Application::class. * - * @param string $version + * @param string $version + * * @author Seven Du */ protected function setVersionToApplicationClass(string $version) @@ -95,9 +97,10 @@ protected function setVersionToPackageJson(string $version) /** * Save package [composer.json] file. * - * @param string $filename - * @param Repository $repository + * @param string $filename + * @param Repository $repository * @return void + * * @author Seven Du */ protected function savePackage(string $filename, Repository $repository) @@ -111,6 +114,7 @@ protected function savePackage(string $filename, Repository $repository) * Get packages. * * @return array + * * @author Seven Du */ protected function getPackages(): array @@ -134,6 +138,7 @@ protected function getPackages(): array * Init the application repositroy. * * @return void + * * @author Seven Du */ protected function initApplicationRepositroy() @@ -144,8 +149,9 @@ protected function initApplicationRepositroy() /** * Create composer repositroy. * - * @param string $path + * @param string $path * @return Repostroy + * * @author Seven Du */ public function createComposerRepositroy(string $path): Repository @@ -159,8 +165,9 @@ public function createComposerRepositroy(string $path): Repository /** * Get file contents. * - * @param string $filename + * @param string $filename * @return mixed + * * @author Seven Du */ public function getFileContents(string $filename) diff --git a/app/Console/Commands/PackageCreateCommand.php b/app/Console/Commands/PackageCreateCommand.php index 4b4bd6f92..546e9fd6b 100644 --- a/app/Console/Commands/PackageCreateCommand.php +++ b/app/Console/Commands/PackageCreateCommand.php @@ -50,6 +50,7 @@ class PackageCreateCommand extends Command * Run the command. * * @return mixed + * * @author Seven Du */ public function handle() @@ -109,8 +110,8 @@ public function handle() * @param \Symfony\Component\Finder\Finder $stubs * @param string $outputPath * @param array $variable - * * @return void + * * @author Seven Du */ protected function putStub( @@ -151,6 +152,7 @@ protected function putStub( * Find stubs. * * @return \Symfony\Component\Finder\Finder + * * @author Seven Du */ protected function findStub(): Finder @@ -167,8 +169,8 @@ protected function findStub(): Finder * format namespace. * * @param string $namespace - * * @return string + * * @author Seven Du */ protected function formatNamespace(string $namespace): string @@ -186,8 +188,8 @@ protected function formatNamespace(string $namespace): string * 格式化名称为驼峰式. * * @param string $name [description] - * * @return string + * * @author Seven Du */ protected function cameCase(string $name): string @@ -202,6 +204,7 @@ protected function cameCase(string $name): string * Question name. * * @return string + * * @author Seven Du */ protected function questionName(): string @@ -223,6 +226,7 @@ protected function questionName(): string * Init composer repository config. * * @return void + * * @author Seven Du */ protected function initRepository() diff --git a/app/Console/Commands/PackageHandlerCommand.php b/app/Console/Commands/PackageHandlerCommand.php index cafdd4241..2c2a4d61c 100644 --- a/app/Console/Commands/PackageHandlerCommand.php +++ b/app/Console/Commands/PackageHandlerCommand.php @@ -45,6 +45,7 @@ class PackageHandlerCommand extends Command * Run the command. * * @return mixed + * * @author Seven Du */ public function handle() @@ -68,6 +69,7 @@ public function handle() * Get package handles. * * @return array + * * @author Seven Du */ public function getHandles(): array @@ -79,6 +81,7 @@ public function getHandles(): array * display handle. * * @return mixed + * * @author Seven Du */ protected function displayHandles() @@ -92,9 +95,10 @@ protected function displayHandles() /** * Display handler method. * - * @param string $name - * @param PackageHandler $handler + * @param string $name + * @param PackageHandler $handler * @return mixed + * * @author Seven Du */ protected function displayMethod(string $name, PackageHandler $handler) @@ -109,8 +113,9 @@ protected function displayMethod(string $name, PackageHandler $handler) /** * Resolve handler. * - * @param string|PackageHandler $handler + * @param string|PackageHandler $handler * @return PackageHandler + * * @author Seven Du */ protected function resolveHandler($handler): PackageHandler diff --git a/app/Console/Kernel.php b/app/Console/Kernel.php index 7da4261f9..db5c2675c 100644 --- a/app/Console/Kernel.php +++ b/app/Console/Kernel.php @@ -39,8 +39,7 @@ class Kernel extends ConsoleKernel /** * Define the application's command schedule. * - * @param \Illuminate\Console\Scheduling\Schedule $schedule - * + * @param \Illuminate\Console\Scheduling\Schedule $schedule * @return void */ protected function schedule(Schedule $schedule) @@ -62,6 +61,7 @@ protected function commands() * Get the Artisan application instance. * * @return \Illuminate\Console\Application + * * @author Seven Du */ protected function getArtisan() diff --git a/app/Contracts/Cdn/UrlFactory.php b/app/Contracts/Cdn/UrlFactory.php index a3299c9d6..de9278cb8 100644 --- a/app/Contracts/Cdn/UrlFactory.php +++ b/app/Contracts/Cdn/UrlFactory.php @@ -27,8 +27,9 @@ interface UrlFactory /** * Get URL generator. * - * @param string $name + * @param string $name * @return \Zhiyi\Plus\Contracts\Cdn\UrlGenerator + * * @author Seven Du */ public function generator(string $name = ''): UrlGenerator; @@ -36,10 +37,11 @@ public function generator(string $name = ''): UrlGenerator; /** * Make a file url. * - * @param \Zhiyi\Plus\Models\File $file - * @param array $extra - * @param string $name + * @param \Zhiyi\Plus\Models\File $file + * @param array $extra + * @param string $name * @return string + * * @author Seven Du */ public function make(File $file, array $extra = [], string $name = ''): string; diff --git a/app/Contracts/Cdn/UrlGenerator.php b/app/Contracts/Cdn/UrlGenerator.php index f2d2c1ae8..9d1530d22 100644 --- a/app/Contracts/Cdn/UrlGenerator.php +++ b/app/Contracts/Cdn/UrlGenerator.php @@ -27,9 +27,10 @@ interface UrlGenerator /** * Generator an absolute URL to the given path. * - * @param string $filename - * @param array $extra "[float $width, float $height, int $quality]" + * @param string $filename + * @param array $extra "[float $width, float $height, int $quality]" * @return string + * * @author Seven Du */ public function url(string $filename, array $extra = []): string; @@ -37,8 +38,9 @@ public function url(string $filename, array $extra = []): string; /** * Refresh the cdn files and dirs. * - * @param \Zhiyi\Plus\Cdn\Refresh $refresh + * @param \Zhiyi\Plus\Cdn\Refresh $refresh * @return void + * * @author Seven Du */ public function refresh(Refresh $refresh); diff --git a/app/Contracts/Model/FetchComment.php b/app/Contracts/Model/FetchComment.php index b6f084363..7ec6e42c3 100644 --- a/app/Contracts/Model/FetchComment.php +++ b/app/Contracts/Model/FetchComment.php @@ -26,6 +26,7 @@ interface FetchComment * Get comment centent. * * @return string + * * @author Seven Du */ public function getCommentContentAttribute(): string; @@ -34,6 +35,7 @@ public function getCommentContentAttribute(): string; * Get target source display title. * * @return string + * * @author Seven Du */ public function getTargetTitleAttribute(): string; @@ -42,6 +44,7 @@ public function getTargetTitleAttribute(): string; * Get target source image file with ID. * * @return int + * * @author Seven Du */ public function getTargetImageAttribute(): int; @@ -50,6 +53,7 @@ public function getTargetImageAttribute(): int; * Get target source id. * * @return int + * * @author Seven Du */ public function getTargetIdAttribute(): int; diff --git a/app/Contracts/Model/UserAbility.php b/app/Contracts/Model/UserAbility.php index ffd6125cb..38e6b6e93 100644 --- a/app/Contracts/Model/UserAbility.php +++ b/app/Contracts/Model/UserAbility.php @@ -25,8 +25,9 @@ interface UserAbility /** * get users all roles. * - * @param string $role + * @param string $role * @return mixed + * * @author Seven Du */ public function roles(string $role = ''); @@ -34,8 +35,9 @@ public function roles(string $role = ''); /** * Get users all abilities. * - * @param string $ability + * @param string $ability * @return mixed + * * @author Seven Du */ public function all(string $ability = ''); diff --git a/app/EaseMobIM/Controllers/EaseMobController.php b/app/EaseMobIM/Controllers/EaseMobController.php index 5c19d1f24..150bbd542 100644 --- a/app/EaseMobIM/Controllers/EaseMobController.php +++ b/app/EaseMobIM/Controllers/EaseMobController.php @@ -99,8 +99,9 @@ public function getToken() /** * 开放注册模式. * - * @param Request $request + * @param Request $request * @return string + * * @author ZsyD<1251992018@qq.com> */ public function openRegister(Request $request) @@ -138,6 +139,7 @@ public function openRegister(Request $request) * * @param $user_id * @return mixed + * * @author ZsyD<1251992018@qq.com> */ public function getImPwdHash($user_id) @@ -150,8 +152,9 @@ public function getImPwdHash($user_id) /** * 授权注册. * - * @param Request $request + * @param Request $request * @return mixed + * * @author ZsyD<1251992018@qq.com> */ public function createUser(Request $request) @@ -193,8 +196,9 @@ public function createUser(Request $request) /** * 批量注册用户. * - * @param Request $request + * @param Request $request * @return mixed + * * @author ZsyD<1251992018@qq.com> */ public function createUsers(Request $request) @@ -244,8 +248,9 @@ public function createUsers(Request $request) /** * 重置环信密码. * - * @param Request $request + * @param Request $request * @return mixed + * * @author ZsyD<1251992018@qq.com> */ public function resetPassword(Request $request) @@ -316,8 +321,9 @@ public function resetPassword(Request $request) /** * 获取环信用户信息，无则新注册一个. * - * @param Request $request + * @param Request $request * @return mixed + * * @author ZsyD<1251992018@qq.com> */ public function getPassword(Request $request) @@ -362,8 +368,9 @@ public function getPassword(Request $request) /** * 删除单个用户. * - * @param Request $request + * @param Request $request * @return mixed + * * @author ZsyD<1251992018@qq.com> */ public function deleteUser(Request $request) @@ -398,12 +405,13 @@ public function deleteUser(Request $request) /** * 发送普通消息 [群组相关时需要]. * - * @param string $content 消息内容 - * @param array $target 消息发送对象 - * @param string $from 消息发送者 - * @param string $target_type users 给用户发消息。chatgroups: 给群发消息，chatrooms: 给聊天室发消息 - * @param array $ext 扩展信息 + * @param string $content 消息内容 + * @param array $target 消息发送对象 + * @param string $from 消息发送者 + * @param string $target_type users 给用户发消息。chatgroups: 给群发消息，chatrooms: 给聊天室发消息 + * @param array $ext 扩展信息 * @return bool + * * @author ZsyD<1251992018@qq.com> */ public function sendCmd(string $content = '', array $target = [], string $from = 'admin', string $target_type = 'chatgroups', array $ext = []) @@ -438,7 +446,8 @@ public function sendCmd(string $content = '', array $target = [], string $from = * 为未注册环信用户注册环信（兼容老用户）. * * @author ZsyD<1251992018@qq.com> - * @param Request $request + * + * @param Request $request * @return mixed */ public function registerOldUsers(Request $request) diff --git a/app/EaseMobIM/Controllers/GroupController.php b/app/EaseMobIM/Controllers/GroupController.php index 981efbe85..287e2a29a 100644 --- a/app/EaseMobIM/Controllers/GroupController.php +++ b/app/EaseMobIM/Controllers/GroupController.php @@ -35,9 +35,11 @@ class GroupController extends EaseMobController /** * 创建群组. * - * @param CheckGroup $request - * @param ImGroup $imGroup + * @param CheckGroup $request + * @param ImGroup $imGroup + * * @author ZsyD<1251992018@qq.com> + * * @return $this */ public function store(CheckGroup $request, ImGroup $imGroup) @@ -104,9 +106,10 @@ public function store(CheckGroup $request, ImGroup $imGroup) /** * 修改群信息. * - * @param UpdateGroup $request - * @param UrlManager $urlManager + * @param UpdateGroup $request + * @param UrlManager $urlManager * @return $this + * * @author ZsyD<1251992018@qq.com> */ public function update(UpdateGroup $request, UrlManager $urlManager) @@ -198,9 +201,10 @@ public function update(UpdateGroup $request, UrlManager $urlManager) /** * 删除群组. * - * @param Request $request - * @param ImGroup $imGroup + * @param Request $request + * @param ImGroup $imGroup * @return $this + * * @author ZsyD<1251992018@qq.com> */ public function delete(Request $request, ImGroup $imGroup) @@ -247,9 +251,10 @@ public function delete(Request $request, ImGroup $imGroup) /** * 获取群信息. * - * @param Request $request - * @param UrlManager $urlManager + * @param Request $request + * @param UrlManager $urlManager * @return $this + * * @author ZsyD<1251992018@qq.com> */ public function newGetGroup(Request $request, UrlManager $urlManager) @@ -331,8 +336,9 @@ public function getGroup(Request $request, UrlManager $urlManager) /** * 获取群头像(多个用","隔开). * - * @param GroupId $request + * @param GroupId $request * @return \Illuminate\Http\JsonResponse + * * @author ZsyD<1251992018@qq.com> */ public function getGroupFace(GroupId $request) @@ -352,6 +358,7 @@ public function getGroupFace(GroupId $request) * @param $members * @param $owner * @return mixed + * * @author ZsyD<1251992018@qq.com> */ private function getUser($members, $owner) @@ -373,8 +380,9 @@ private function getUser($members, $owner) /** * 添加群成员(多个用","隔开). * - * @param GroupMember $request + * @param GroupMember $request * @return $this + * * @author ZsyD<1251992018@qq.com> */ public function addGroupMembers(GroupMember $request) @@ -431,8 +439,9 @@ public function addGroupMembers(GroupMember $request) /** * 移除群成员(多个用","隔开). * - * @param GroupMember $request + * @param GroupMember $request * @return $this + * * @author ZsyD<1251992018@qq.com> */ public function removeGroupMembers(GroupMember $request) diff --git a/app/Exceptions/Handler.php b/app/Exceptions/Handler.php index b53cd969d..05f693518 100644 --- a/app/Exceptions/Handler.php +++ b/app/Exceptions/Handler.php @@ -51,6 +51,7 @@ class Handler extends ExceptionHandler * Register the exception handling callbacks for the application. * * @return void + * * @throws \Throwable */ public function register() @@ -63,8 +64,8 @@ public function register() * * @param $request * @param \Throwable $exception - * * @return \Illuminate\Http\Response + * * @throws \Throwable */ public function render($request, \Throwable $exception) @@ -75,9 +76,10 @@ public function render($request, \Throwable $exception) /** * Convert a validation exception into a JSON response. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Validation\ValidationException $exception + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Validation\ValidationException $exception * @return \Illuminate\Http\JsonResponse + * * @author Seven Du */ protected function invalidJson($request, \Illuminate\Validation\ValidationException $exception) diff --git a/app/Exceptions/ValidationException.php b/app/Exceptions/ValidationException.php index 7703d7f8e..e9950b268 100644 --- a/app/Exceptions/ValidationException.php +++ b/app/Exceptions/ValidationException.php @@ -27,7 +27,8 @@ class ValidationException extends IlluminateValidationException /** * Create a new exception instance. * - * @param \Illuminate\Validation\ValidationException $exception + * @param \Illuminate\Validation\ValidationException $exception + * * @author Seven Du */ public function __construct(IlluminateValidationException $exception) diff --git a/app/FileStorage/ChannelManager.php b/app/FileStorage/ChannelManager.php index 05743bd2d..bd05dcaa6 100644 --- a/app/FileStorage/ChannelManager.php +++ b/app/FileStorage/ChannelManager.php @@ -30,20 +30,23 @@ class ChannelManager extends Manager { /** * Support drives. + * * @var array */ public const DRIVES = ['public', 'protected', 'private']; /** * Filesystem manager. + * * @var \Zhiyi\Plus\FileStorage\FilesystemManager */ protected $fielsystemManager; /** * Create the manager instance. - * @param \Zhiyi\Plus\AppInterface $app - * @param \Zhiyi\Plus\FileStorage\FilesystemManager $fielsystemManager + * + * @param \Zhiyi\Plus\AppInterface $app + * @param \Zhiyi\Plus\FileStorage\FilesystemManager $fielsystemManager */ public function __construct(AppInterface $app, FilesystemManager $fielsystemManager) { @@ -61,6 +64,7 @@ public function getDefaultDriver() /** * Create public channel driver. + * * @return \Zhiyi\Plus\FileStorage\Channels\ChannelInterface */ protected function createPublicDriver(): ChannelInterface diff --git a/app/FileStorage/Channels/AbstractChannel.php b/app/FileStorage/Channels/AbstractChannel.php index 07c711857..d238fa5da 100644 --- a/app/FileStorage/Channels/AbstractChannel.php +++ b/app/FileStorage/Channels/AbstractChannel.php @@ -29,25 +29,29 @@ abstract class AbstractChannel implements ChannelInterface { /** * The resource. + * * @var \Zhiyi\Plus\FileStorage\ResourceInterface */ protected $resource; /** * A request instance. + * * @var \Illuminate\Http\Request */ protected $request; /** * Filesystem. + * * @var \Zhiyi\Plus\FileStorage\Filesystems\FilesystemInterface */ protected $filesystem; /** * Set request. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return void */ public function setRequest(Request $request): void @@ -57,7 +61,8 @@ public function setRequest(Request $request): void /** * Set resource. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource * @return void */ public function setResource(ResourceInterface $resource): void @@ -67,7 +72,8 @@ public function setResource(ResourceInterface $resource): void /** * Set filesystem. - * @param \Zhiyi\Plus\FileStorage\Filesystems\FilesystemInterface $filesystem + * + * @param \Zhiyi\Plus\FileStorage\Filesystems\FilesystemInterface $filesystem * @return void */ public function setFilesystem(FilesystemInterface $filesystem): void @@ -77,7 +83,8 @@ public function setFilesystem(FilesystemInterface $filesystem): void /** * Put a file. - * @param mixed $contents + * + * @param mixed $contents * @return vodi */ public function put($contents): bool @@ -87,7 +94,8 @@ public function put($contents): bool /** * Get a resource response. - * @param string|null $rule + * + * @param string|null $rule * @return \Symfony\Component\HttpFoundation\Response */ public function response(?string $rule = null): Response diff --git a/app/FileStorage/Channels/ChannelInterface.php b/app/FileStorage/Channels/ChannelInterface.php index 5da692460..f39e95462 100644 --- a/app/FileStorage/Channels/ChannelInterface.php +++ b/app/FileStorage/Channels/ChannelInterface.php @@ -31,53 +31,61 @@ interface ChannelInterface { /** * Set resource. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource * @return void */ public function setResource(ResourceInterface $resource): void; /** * Set request. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return void */ public function setRequest(Request $request): void; /** * Set filesystem. - * @param \Zhiyi\Plus\FileStorage\Filesystems\FilesystemInterface $filesystem + * + * @param \Zhiyi\Plus\FileStorage\Filesystems\FilesystemInterface $filesystem * @return void */ public function setFilesystem(FilesystemInterface $filesystem): void; /** * Create a upload task. + * * @return \Zhiyi\Plus\FileStorage\TaskInterface */ public function createTask(): TaskInterface; /** * Get a resource meta. + * * @return \Zhiyi\Plus\FileStorage\FileMetaInterface */ public function meta(): FileMetaInterface; /** * Get a resource response. - * @param string|null $rule + * + * @param string|null $rule * @return \Symfony\Component\HttpFoundation\Response */ public function response(?string $rule = null): Response; /** * Uploaded callback handler. + * * @return void */ public function callback(): void; /** * Put a file. - * @param mixed $contents + * + * @param mixed $contents * @return vodi */ public function put($contents): bool; diff --git a/app/FileStorage/Channels/PublicChannel.php b/app/FileStorage/Channels/PublicChannel.php index b96be855f..3b8daa348 100644 --- a/app/FileStorage/Channels/PublicChannel.php +++ b/app/FileStorage/Channels/PublicChannel.php @@ -27,6 +27,7 @@ class PublicChannel extends AbstractChannel { /** * Create a upload task. + * * @return \Zhiyi\Plus\FileStorage\TaskInterface */ public function createTask(): TaskInterface @@ -36,6 +37,7 @@ public function createTask(): TaskInterface /** * Get a resource meta. + * * @return \Zhiyi\Plus\FileStorage\FileMetaInterface */ public function meta(): FileMetaInterface @@ -45,6 +47,7 @@ public function meta(): FileMetaInterface /** * Uploaded callback handler. + * * @return void */ public function callback(): void diff --git a/app/FileStorage/FileMetaAbstract.php b/app/FileStorage/FileMetaAbstract.php index 240eda53f..f51024842 100644 --- a/app/FileStorage/FileMetaAbstract.php +++ b/app/FileStorage/FileMetaAbstract.php @@ -58,6 +58,7 @@ public function toJson($options = 0): string /** * Convert the object to its JSON representation. + * * @return string */ public function jsonSerialize(): string diff --git a/app/FileStorage/FileMetaInterface.php b/app/FileStorage/FileMetaInterface.php index f8dcd0779..6647a6c1b 100644 --- a/app/FileStorage/FileMetaInterface.php +++ b/app/FileStorage/FileMetaInterface.php @@ -30,43 +30,50 @@ interface FileMetaInterface extends Arrayable, JsonSerializable, Jsonable { /** * Has the file is image. + * * @return bool */ public function hasImage(): bool; /** * Get image file dimension. + * * @return \Zhiyi\Plus\FileStorage\ImageDimensionInterface */ public function getImageDimension(): ImageDimensionInterface; /** * Get the file size (Byte). + * * @return int */ public function getSize(): int; /** * Get the resource mime type. + * * @return string */ public function getMimeType(): string; /** * Get the storage vendor name. + * * @return string */ public function getVendorName(): string; /** * Get the resource pay info. - * @param \Zhiyi\Plus\Models\User $user + * + * @param \Zhiyi\Plus\Models\User $user * @return \Zhiyi\Plus\FileStorage\Pay\PayInterface */ public function getPay(User $user): ?PayInterface; /** * Get the resource url. + * * @return string */ public function url(): string; diff --git a/app/FileStorage/FilesystemManager.php b/app/FileStorage/FilesystemManager.php index 0f344ca5f..5d0ef8abe 100644 --- a/app/FileStorage/FilesystemManager.php +++ b/app/FileStorage/FilesystemManager.php @@ -37,7 +37,9 @@ public function getDefaultDriver() /** * Create local driver. + * * @return \Zhiyi\Plus\FileStorage\Filesystems\FilesystemInterface + * * @throws \Illuminate\Contracts\Container\BindingResolutionException */ public function createLocalDriver(): Filesystems\FilesystemInterface @@ -55,7 +57,9 @@ public function createLocalDriver(): Filesystems\FilesystemInterface /** * Create Aliyun OSS filesystem driver. + * * @return \Zhiyi\Plus\FileStorage\Filesystems\FilesystemInterface + * * @throws \OSS\Core\OssException */ public function createAliyunOSSDriver(): Filesystems\FilesystemInterface diff --git a/app/FileStorage/Filesystems/AliyunOss/FileMeta.php b/app/FileStorage/Filesystems/AliyunOss/FileMeta.php index 7ebb188ea..4ceb2bbce 100644 --- a/app/FileStorage/Filesystems/AliyunOss/FileMeta.php +++ b/app/FileStorage/Filesystems/AliyunOss/FileMeta.php @@ -43,9 +43,10 @@ class FileMeta extends FileMetaAbstract /** * Create a file meta. - * @param \OSS\OssClient $oss - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource - * @param string $bucket + * + * @param \OSS\OssClient $oss + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * @param string $bucket */ public function __construct(OssClient $oss, ResourceInterface $resource, string $bucket) { @@ -57,6 +58,7 @@ public function __construct(OssClient $oss, ResourceInterface $resource, string /** * Has the file is image. + * * @return bool */ public function hasImage(): bool @@ -68,6 +70,7 @@ public function hasImage(): bool /** * Get image file dimension. + * * @return \Zhiyi\Plus\FileStorage\ImageDimensionInterface */ public function getImageDimension(): ImageDimensionInterface @@ -88,6 +91,7 @@ public function getImageDimension(): ImageDimensionInterface /** * Get the file size (Byte). + * * @return int */ public function getSize(): int @@ -99,6 +103,7 @@ public function getSize(): int /** * Get the resource mime type. + * * @return string */ public function getMimeType(): string @@ -108,6 +113,7 @@ public function getMimeType(): string /** * Get the storage vendor name. + * * @return string */ public function getVendorName(): string @@ -117,7 +123,8 @@ public function getVendorName(): string /** * Get the resource pay info. - * @param \Zhiyi\Plus\Models\User $user + * + * @param \Zhiyi\Plus\Models\User $user * @return \Zhiyi\Plus\FileStorage\Pay\PayInterface */ public function getPay(User $user): ?PayInterface @@ -127,6 +134,7 @@ public function getPay(User $user): ?PayInterface /** * Get the resource url. + * * @return string */ public function url(): string @@ -139,6 +147,7 @@ public function url(): string /** * Custom using MIME types. + * * @return null\Closure */ protected function useCustomTypes(): ?Closure diff --git a/app/FileStorage/Filesystems/AliyunOssFilesystem.php b/app/FileStorage/Filesystems/AliyunOssFilesystem.php index 901de30ff..14a1c6797 100644 --- a/app/FileStorage/Filesystems/AliyunOssFilesystem.php +++ b/app/FileStorage/Filesystems/AliyunOssFilesystem.php @@ -40,8 +40,9 @@ class AliyunOssFilesystem implements FilesystemInterface /** * Create the Aliyun OSS filesystem instance. - * @param \OSS\OssClient $oss - * @param array $configure + * + * @param \OSS\OssClient $oss + * @param array $configure */ public function __construct(OssClient $oss, OssClient $insideOss, array $configure) { @@ -52,8 +53,9 @@ public function __construct(OssClient $oss, OssClient $insideOss, array $configu /** * Create upload task. - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource * @return \Zhiyi\Plus\FileStorage\TaskInterface */ public function createTask(Request $request, ResourceInterface $resource): TaskInterface @@ -94,7 +96,8 @@ public function createTask(Request $request, ResourceInterface $resource): TaskI /** * Get file meta. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource * @return \Zhiyi\Plus\FileStorage\FileMetaInterface */ public function meta(ResourceInterface $resource): FileMetaInterface @@ -110,8 +113,9 @@ public function meta(ResourceInterface $resource): FileMetaInterface /** * Get file response. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource - * @param string|null $rule + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * @param string|null $rule * @return \Symfony\Component\HttpFoundation\Response */ public function response(ResourceInterface $resource, ?string $rule = null): Response @@ -131,7 +135,8 @@ public function response(ResourceInterface $resource, ?string $rule = null): Res /** * Delete file. - * @param string $path + * + * @param string $path * @return bool */ public function delete(string $path): bool @@ -143,8 +148,9 @@ public function delete(string $path): bool /** * Put a file. - * @param string $path - * @param mixed $contents + * + * @param string $path + * @param mixed $contents * @return bool */ public function put(string $path, $contents): bool diff --git a/app/FileStorage/Filesystems/FilesystemInterface.php b/app/FileStorage/Filesystems/FilesystemInterface.php index 2a7b92aa0..847e0d9f7 100644 --- a/app/FileStorage/Filesystems/FilesystemInterface.php +++ b/app/FileStorage/Filesystems/FilesystemInterface.php @@ -30,38 +30,43 @@ interface FilesystemInterface { /** * Get file meta. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource * @return \Zhiyi\Plus\FileStorage\FileMetaInterface */ public function meta(ResourceInterface $resource): FileMetaInterface; /** * Get file response. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource - * @param string|null $rule + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * @param string|null $rule * @return \Symfony\Component\HttpFoundation\Response */ public function response(ResourceInterface $resource, ?string $rule = null): Response; /** * Delete file. - * @param string $path + * + * @param string $path * @return bool */ public function delete(string $path): bool; /** * Create upload task. - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource * @return \Zhiyi\Plus\FileStorage\TaskInterface */ public function createTask(Request $request, ResourceInterface $resource): TaskInterface; /** * Put a file. - * @param string $path - * @param mixed $contents + * + * @param string $path + * @param mixed $contents * @return bool */ public function put(string $path, $contents): bool; diff --git a/app/FileStorage/Filesystems/Local/FileMeta.php b/app/FileStorage/Filesystems/Local/FileMeta.php index 0751e7bf2..86e093d75 100644 --- a/app/FileStorage/Filesystems/Local/FileMeta.php +++ b/app/FileStorage/Filesystems/Local/FileMeta.php @@ -37,26 +37,30 @@ class FileMeta extends FileMetaAbstract /** * Local filesystem. + * * @var \Illuminate\Contracts\Filesystem\Filesystem */ protected $filesystem; /** * Resource instance. + * * @var \Zhiyi\Plus\FileStorage\ResourceInterface */ protected $resource; /** * Cache the instance image dimension. + * * @var \Zhiyi\Plus\FileStorage\ImageDimensionInterface */ protected $dimension; /** * Create a file meta. - * @param \Illuminate\Contracts\Filesystem\Filesystem $filesystem - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Illuminate\Contracts\Filesystem\Filesystem $filesystem + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource */ public function __construct(FilesystemContract $filesystem, ResourceInterface $resource) { @@ -67,6 +71,7 @@ public function __construct(FilesystemContract $filesystem, ResourceInterface $r /** * Use custom MIME types. + * * @return null|\Closure */ protected function useCustomTypes(): ?Closure @@ -83,6 +88,7 @@ protected function useCustomTypes(): ?Closure /** * Has the file is image. + * * @return bool */ public function hasImage(): bool @@ -94,6 +100,7 @@ public function hasImage(): bool /** * Get image file dimension. + * * @return \Zhiyi\Plus\FileStorage\ImageDimensionInterface */ public function getImageDimension(): ImageDimensionInterface @@ -114,6 +121,7 @@ public function getImageDimension(): ImageDimensionInterface /** * Get the file size (Byte). + * * @return int */ public function getSize(): int @@ -125,6 +133,7 @@ public function getSize(): int /** * Get the resource mime type. + * * @return string */ public function getMimeType(): string @@ -136,7 +145,8 @@ public function getMimeType(): string /** * Get the resource pay info. - * @param \Zhiyi\Plus\Models\User $user + * + * @param \Zhiyi\Plus\Models\User $user * @return \Zhiyi\Plus\FileStorage\Pay\PayInterface */ public function getPay(User $user): ?PayInterface @@ -146,6 +156,7 @@ public function getPay(User $user): ?PayInterface /** * Get the storage vendor name. + * * @return string */ public function getVendorName(): string @@ -155,6 +166,7 @@ public function getVendorName(): string /** * Get the resource url. + * * @return string */ public function url(): string diff --git a/app/FileStorage/Filesystems/Local/RuleParser.php b/app/FileStorage/Filesystems/Local/RuleParser.php index daa63940c..3f9906fc5 100644 --- a/app/FileStorage/Filesystems/Local/RuleParser.php +++ b/app/FileStorage/Filesystems/Local/RuleParser.php @@ -24,13 +24,15 @@ class RuleParser { /** * Cacheing the rules. + * * @var array */ protected $rule = []; /** * Create a new rule. - * @param null|string $rule + * + * @param null|string $rule */ public function __construct(?string $rule = null) { @@ -41,7 +43,8 @@ public function __construct(?string $rule = null) /** * Parse a rule. - * @param null|string $rule + * + * @param null|string $rule * @return void */ protected function parse(?string $rule): void @@ -59,8 +62,9 @@ protected function parse(?string $rule): void /** * Get rule. - * @param string $key - * @param mixed $default + * + * @param string $key + * @param mixed $default * @return mixed */ public function getRule(string $key, $default) @@ -75,6 +79,7 @@ public function getRule(string $key, $default) /** * Get quality. + * * @return int */ public function getQuality(): int @@ -84,6 +89,7 @@ public function getQuality(): int /** * Get blur. + * * @return int */ public function getBlur(): int @@ -97,6 +103,7 @@ public function getBlur(): int /** * Get width. + * * @return null|float */ public function getWidth(): ?float @@ -108,6 +115,7 @@ public function getWidth(): ?float /** * Get height. + * * @return null|float */ public function getHeight(): ?float @@ -119,6 +127,7 @@ public function getHeight(): ?float /** * Get cacheing filename. + * * @return string */ public function getFilename(): string diff --git a/app/FileStorage/Filesystems/LocalFilesystem.php b/app/FileStorage/Filesystems/LocalFilesystem.php index 5cf163d28..bc299c1e9 100644 --- a/app/FileStorage/Filesystems/LocalFilesystem.php +++ b/app/FileStorage/Filesystems/LocalFilesystem.php @@ -38,19 +38,22 @@ class LocalFilesystem implements FilesystemInterface { /** * The local filesystem. + * * @var \Illuminate\Contracts\Filesystem\Filesystem */ protected $filesystem; /** * Cache the file metas. + * * @var array<\Zhiyi\Plus\FileStorage\FileMetaInterface> */ protected $metas = []; /** * Create the filesystem driver instance. - * @param \\Illuminate\Contracts\Filesystem\Filesystem $folesystem + * + * @param \\Illuminate\Contracts\Filesystem\Filesystem $folesystem */ public function __construct(FilesystemContract $filesystem) { @@ -59,7 +62,8 @@ public function __construct(FilesystemContract $filesystem) /** * Get file meta. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource * @return \Zhiyi\Plus\FileStorage\FileMetaInterface */ public function meta(ResourceInterface $resource): FileMetaInterface @@ -76,8 +80,9 @@ public function meta(ResourceInterface $resource): FileMetaInterface /** * Get file response. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource - * @param string|null $rule + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * @param string|null $rule * @return \Symfony\Component\HttpFoundation\Response */ public function response(ResourceInterface $resource, ?string $rule = null): Response @@ -120,7 +125,8 @@ public function response(ResourceInterface $resource, ?string $rule = null): Res /** * Delete file. - * @param string $path + * + * @param string $path * @return bool */ public function delete(string $path): bool @@ -136,8 +142,9 @@ public function delete(string $path): bool /** * Create upload task. - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource * @return \Zhiyi\Plus\FileStorage\TaskInterface */ public function createTask(Request $request, ResourceInterface $resource): TaskInterface @@ -161,8 +168,9 @@ public function createTask(Request $request, ResourceInterface $resource): TaskI /** * Put a file. - * @param string $path - * @param mixed $contents + * + * @param string $path + * @param mixed $contents * @return bool */ public function put(string $path, $contents): bool diff --git a/app/FileStorage/Http/Controllers/Callback.php b/app/FileStorage/Http/Controllers/Callback.php index 040ff5043..8559d8b98 100644 --- a/app/FileStorage/Http/Controllers/Callback.php +++ b/app/FileStorage/Http/Controllers/Callback.php @@ -28,13 +28,15 @@ class Callback { /** * File storage instance. + * * @var \Zhiyi\Plus\FileStorage\StorageInterface */ protected $storage; /** * Create the controller instance. - * @param \Zhiyi\Plus\FileStorage\StorageInterface $storage + * + * @param \Zhiyi\Plus\FileStorage\StorageInterface $storage */ public function __construct(StorageInterface $storage) { @@ -43,8 +45,9 @@ public function __construct(StorageInterface $storage) /** * Callcack handler. - * @param string $channel - * @param string $path + * + * @param string $channel + * @param string $path * @return \Illuminate\Http\JsonResponse; */ public function __invoke(string $channel, string $path): JsonResponse diff --git a/app/FileStorage/Http/Controllers/CreateTask.php b/app/FileStorage/Http/Controllers/CreateTask.php index 740ce2e7e..c26cb2ecd 100644 --- a/app/FileStorage/Http/Controllers/CreateTask.php +++ b/app/FileStorage/Http/Controllers/CreateTask.php @@ -37,8 +37,9 @@ public function __construct() /** * Create a upload task. - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Plus\FileStorage\StorageInterface $storage + * + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Plus\FileStorage\StorageInterface $storage * @return \Illuminate\Http\JsonResponse */ public function __invoke(Request $request, StorageInterface $storage) diff --git a/app/FileStorage/Http/Controllers/Local.php b/app/FileStorage/Http/Controllers/Local.php index 232835f89..f88fbf35f 100644 --- a/app/FileStorage/Http/Controllers/Local.php +++ b/app/FileStorage/Http/Controllers/Local.php @@ -39,13 +39,15 @@ class Local extends Controller { /** * File storage instance. + * * @var \Zhiyi\Plus\FileStorage\StorageInterface */ protected $storage; /** * Create the controller instance. - * @param \Zhiyi\Plus\FileStorage\StorageInterface $storage + * + * @param \Zhiyi\Plus\FileStorage\StorageInterface $storage */ public function __construct(StorageInterface $storage) { @@ -61,9 +63,10 @@ public function __construct(StorageInterface $storage) /** * Get a file. - * @param \Illuminate\Http\Request $request - * @param string $channel - * @param string $path + * + * @param \Illuminate\Http\Request $request + * @param string $channel + * @param string $path * @return \Symfony\Component\HttpFoundation\Response */ public function get(Request $request, string $channel, string $path): Response @@ -75,10 +78,11 @@ public function get(Request $request, string $channel, string $path): Response /** * Put a file. - * @param \Illuminate\Http\Request $request - * @param s\Illuminate\Contracts\Cache\Factory $cache - * @param string $channel - * @param string $path + * + * @param \Illuminate\Http\Request $request + * @param s\Illuminate\Contracts\Cache\Factory $cache + * @param string $channel + * @param string $path * @return Symfony\Component\HttpFoundation\Response */ public function put(Request $request, FactoryContract $cache, string $channel, string $path): JsonResponse diff --git a/app/FileStorage/Http/MakeRoutes.php b/app/FileStorage/Http/MakeRoutes.php index 910388d8b..13ad42e41 100644 --- a/app/FileStorage/Http/MakeRoutes.php +++ b/app/FileStorage/Http/MakeRoutes.php @@ -26,13 +26,15 @@ class MakeRoutes { /** * The router instance. + * * @var \Illuminate\Contracts\Routing\Registrar */ protected $router; /** * Create the maker instance. - * @param \Illuminate\Contracts\Routing\Registrar $router + * + * @param \Illuminate\Contracts\Routing\Registrar $router */ public function __construct(RegistrarContract $router) { @@ -41,6 +43,7 @@ public function __construct(RegistrarContract $router) /** * The routes resister. + * * @return void */ public function register(): void @@ -52,6 +55,7 @@ public function register(): void /** * Register local filesystem routes. + * * @return void */ protected function registerLocalFilesystemRoutes(): void @@ -68,6 +72,7 @@ protected function registerLocalFilesystemRoutes(): void /** * Register channel callback routes. + * * @return void */ protected function registerChannelCallbackRoutes(): void @@ -81,6 +86,7 @@ protected function registerChannelCallbackRoutes(): void /** * Register create a upload task routes. + * * @return void */ protected function registerCreateTaskRoutes(): void diff --git a/app/FileStorage/ImageDimension.php b/app/FileStorage/ImageDimension.php index 05dffee40..d3a66ae41 100644 --- a/app/FileStorage/ImageDimension.php +++ b/app/FileStorage/ImageDimension.php @@ -24,20 +24,23 @@ class ImageDimension implements ImageDimensionInterface { /** * The dimension width. + * * @var float */ protected $width; /** * The dimnsion height. + * * @var float */ protected $height; /** * Create a image dimension. - * @param float $width - * @param float $height + * + * @param float $width + * @param float $height */ public function __construct(float $width, float $height) { @@ -47,6 +50,7 @@ public function __construct(float $width, float $height) /** * Get image width (px). + * * @return float */ public function getWidth(): float @@ -56,6 +60,7 @@ public function getWidth(): float /** * Get image height (px). + * * @return float */ public function getHeight(): float diff --git a/app/FileStorage/ImageDimensionInterface.php b/app/FileStorage/ImageDimensionInterface.php index be88e8fd9..6840e2c36 100644 --- a/app/FileStorage/ImageDimensionInterface.php +++ b/app/FileStorage/ImageDimensionInterface.php @@ -24,12 +24,14 @@ interface ImageDimensionInterface { /** * Get image width (px). + * * @return float */ public function getWidth(): float; /** * Get image height (px). + * * @return float */ public function getHeight(): float; diff --git a/app/FileStorage/Pay/PayInterface.php b/app/FileStorage/Pay/PayInterface.php index d42e8dbaa..ba01b4722 100644 --- a/app/FileStorage/Pay/PayInterface.php +++ b/app/FileStorage/Pay/PayInterface.php @@ -24,24 +24,28 @@ interface PayInterface { /** * Get paid status. + * * @return bool */ public function getPaid(): bool; /** * Get file paid node amount. + * * @return int */ public function getAmount(): int; /** * Get pay node. + * * @return string */ public function getNode(): string; /** * Get pay type. + * * @return string */ public function getType(): string; diff --git a/app/FileStorage/Resource.php b/app/FileStorage/Resource.php index 0b6e4f1dc..11ecb86d5 100644 --- a/app/FileStorage/Resource.php +++ b/app/FileStorage/Resource.php @@ -24,12 +24,14 @@ class Resource implements ResourceInterface { /** * The resource channel name. + * * @var string */ protected $channel; /** * The resource path. + * * @var string */ protected $path; @@ -41,8 +43,9 @@ class Resource implements ResourceInterface /** * Create a resource. - * @param string $resource E.g "public:/feed/2018/08/HDUi89aHD7Dhnmc8NMud8D90d.png"/"public" - * @param string|null $path + * + * @param string $resource E.g "public:/feed/2018/08/HDUi89aHD7Dhnmc8NMud8D90d.png"/"public" + * @param string|null $path */ public function __construct(string $resource, ?string $path = null) { @@ -68,6 +71,7 @@ public function __construct(string $resource, ?string $path = null) /** * Get the resource channel. + * * @return string */ public function getChannel(): string @@ -77,6 +81,7 @@ public function getChannel(): string /** * Get the resource path. + * * @return string */ public function getPath(): string @@ -86,6 +91,7 @@ public function getPath(): string /** * The resource to string. + * * @return string */ public function __toString(): string diff --git a/app/FileStorage/ResourceInterface.php b/app/FileStorage/ResourceInterface.php index ec710ca38..fc7b8a19d 100644 --- a/app/FileStorage/ResourceInterface.php +++ b/app/FileStorage/ResourceInterface.php @@ -24,18 +24,21 @@ interface ResourceInterface { /** * Get the resource channel. + * * @return string */ public function getChannel(): string; /** * Get the resource path. + * * @return string */ public function getPath(): string; /** * The resource to string. + * * @return string */ public function __toString(): string; diff --git a/app/FileStorage/Storage.php b/app/FileStorage/Storage.php index 2a78925e2..8a739d73b 100644 --- a/app/FileStorage/Storage.php +++ b/app/FileStorage/Storage.php @@ -61,7 +61,6 @@ public function __construct( * Create a upload task. * * @param Request $request - * * @return TaskInterface */ public function createTask(Request $request): TaskInterface @@ -88,7 +87,6 @@ public function createTask(Request $request): TaskInterface * Get a file info. * * @param ResourceInterface $resource - * * @return \Zhiyi\Plus\FileMetaInterface */ public function meta(ResourceInterface $resource): FileMetaInterface @@ -101,7 +99,6 @@ public function meta(ResourceInterface $resource): FileMetaInterface * * @param ResourceInterface $resource * @param string|null $rule - * * @return string */ public function response(ResourceInterface $resource, ?string $rule = null): Response @@ -113,7 +110,6 @@ public function response(ResourceInterface $resource, ?string $rule = null): Res * Deelte a resource. * * @param ResourceInterface $resource - * * @return bool */ public function delete(ResourceInterface $resource): ?bool @@ -126,7 +122,6 @@ public function delete(ResourceInterface $resource): ?bool * * @param ResourceInterface $resource * @param mixed $content - * * @return bool */ public function put(ResourceInterface $resource, $content): bool @@ -138,7 +133,6 @@ public function put(ResourceInterface $resource, $content): bool * A storage task callback handle. * * @param ResourceInterface $resource - * * @return void */ public function callback(ResourceInterface $resource): void @@ -150,7 +144,6 @@ public function callback(ResourceInterface $resource): void * Get a channel instance. * * @param ResourceInterface $resource - * * @return ChannelInterface */ public function getChannel(ResourceInterface $resource): ChannelInterface @@ -165,7 +158,6 @@ public function getChannel(ResourceInterface $resource): ChannelInterface * Make a new path. * * @param string $filename - * * @return string */ public function makePath(string $filename): string diff --git a/app/FileStorage/StorageInterface.php b/app/FileStorage/StorageInterface.php index ced5a7773..453f01e2c 100644 --- a/app/FileStorage/StorageInterface.php +++ b/app/FileStorage/StorageInterface.php @@ -27,44 +27,50 @@ interface StorageInterface { /** * Create a file storage task. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return \Zhiyi\Plus\FileStorage\TaskInterface */ public function createTask(Request $request): TaskInterface; /** * Get a file info. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource * @return \Zhiyi\Plus\FileMetaInterface */ public function meta(ResourceInterface $resource): FileMetaInterface; /** * Get a file response. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource - * @param string|null $rule + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * @param string|null $rule * @return string */ public function response(ResourceInterface $resource, ?string $rule = null): Response; /** * Deelte a resource. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource * @return bool */ public function delete(ResourceInterface $resource): ?bool; /** * Put a file. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource - * @param mixed $content + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * @param mixed $content * @return bool */ public function put(ResourceInterface $resource, $content): bool; /** * A storage task callback handle. - * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource + * + * @param \Zhiyi\Plus\FileStorage\ResourceInterface $resource * @return void */ public function callback(ResourceInterface $resource): void; diff --git a/app/FileStorage/Task.php b/app/FileStorage/Task.php index 90ae1dbdb..a8a70a253 100644 --- a/app/FileStorage/Task.php +++ b/app/FileStorage/Task.php @@ -41,6 +41,7 @@ public function __construct(ResourceInterface $resource, string $uri, string $me /** * Get the task URI. + * * @return string */ public function getUri(): string @@ -50,6 +51,7 @@ public function getUri(): string /** * Get the task method. + * * @return string */ public function getMethod(): string @@ -59,6 +61,7 @@ public function getMethod(): string /** * Get the task headers. + * * @return array */ public function getHeaders(): array @@ -68,6 +71,7 @@ public function getHeaders(): array /** * Get the task form. + * * @return null|array */ public function getForm(): ?array @@ -77,6 +81,7 @@ public function getForm(): ?array /** * Get the task file key. + * * @return null|string */ public function getFileKey(): ?string @@ -86,6 +91,7 @@ public function getFileKey(): ?string /** * Get resource node string. + * * @return string */ public function getNode(): string diff --git a/app/FileStorage/TaskInterface.php b/app/FileStorage/TaskInterface.php index bc8c552ba..a33e398fc 100644 --- a/app/FileStorage/TaskInterface.php +++ b/app/FileStorage/TaskInterface.php @@ -24,36 +24,42 @@ interface TaskInterface { /** * Get the task URI. + * * @return string */ public function getUri(): string; /** * Get the task method. + * * @return string */ public function getMethod(): string; /** * Get the task headers. + * * @return array */ public function getHeaders(): array; /** * Get the task form. + * * @return null|array */ public function getForm(): ?array; /** * Get the task file key. + * * @return null|string */ public function getFileKey(): ?string; /** * Get resource node string. + * * @return string */ public function getNode(): string; diff --git a/app/FileStorage/Traits/EloquentAttributeTrait.php b/app/FileStorage/Traits/EloquentAttributeTrait.php index 627fb52d0..67f4dc79f 100644 --- a/app/FileStorage/Traits/EloquentAttributeTrait.php +++ b/app/FileStorage/Traits/EloquentAttributeTrait.php @@ -29,6 +29,7 @@ trait EloquentAttributeTrait { /** * Get file storage instance. + * * @return \Zhiyi\Plus\FileStorage\StorageInterface */ protected function getFileStorageInstance(): StorageInterface @@ -38,7 +39,8 @@ protected function getFileStorageInstance(): StorageInterface /** * Get resource meta. - * @param string $resource + * + * @param string $resource * @return null|\Zhiyi\Plus\FileStorage\FileMeatInterface */ protected function getFileStorageResourceMeta(string $resource): ?FileMetaInterface diff --git a/app/FileStorage/Traits/HasImageTrait.php b/app/FileStorage/Traits/HasImageTrait.php index 58e817919..6e39194f9 100644 --- a/app/FileStorage/Traits/HasImageTrait.php +++ b/app/FileStorage/Traits/HasImageTrait.php @@ -26,12 +26,14 @@ trait HasImageTrait { /** * Custom using MIME types. + * * @return null\Closure */ abstract protected function useCustomTypes(): ?Closure; /** * Get support image MIME types. + * * @return array */ protected function getImageMimeTypes(): array @@ -53,7 +55,8 @@ protected function getImageMimeTypes(): array /** * Check is support image type. - * @param string $mimeTypes + * + * @param string $mimeTypes * @return bool */ protected function hasImageType(string $mimeTypes): bool diff --git a/app/FileStorage/Validators/AbstractValidator.php b/app/FileStorage/Validators/AbstractValidator.php index 211d6f1b8..01ea574ac 100644 --- a/app/FileStorage/Validators/AbstractValidator.php +++ b/app/FileStorage/Validators/AbstractValidator.php @@ -32,7 +32,8 @@ abstract class AbstractValidator implements ValidatorInterface /** * The Validator validate handle. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return void */ public function validate(Request $request): void @@ -42,12 +43,14 @@ public function validate(Request $request): void /** * get The validator rules. + * * @return array */ abstract public function rules(): array; /** * Get the validate error messages. + * * @return array */ public function messages(): array @@ -57,6 +60,7 @@ public function messages(): array /** * Get the validate attribute custom name. + * * @return array */ public function customAttributes(): array diff --git a/app/FileStorage/Validators/CreateTaskValidator.php b/app/FileStorage/Validators/CreateTaskValidator.php index 871328a47..4238ddf39 100644 --- a/app/FileStorage/Validators/CreateTaskValidator.php +++ b/app/FileStorage/Validators/CreateTaskValidator.php @@ -28,12 +28,14 @@ class CreateTaskValidator extends AbstractValidator { /** * Caching configures. + * * @var array */ protected $configure; /** * Get the validate rules. + * * @return array */ public function rules(bool $image = false): array @@ -60,6 +62,7 @@ public function rules(bool $image = false): array /** * Get the validate error messages. + * * @return array */ public function messages(): array @@ -71,6 +74,7 @@ public function messages(): array /** * Get image allow min width. + * * @return string */ protected function getAllowImageMinWidth(): string @@ -80,6 +84,7 @@ protected function getAllowImageMinWidth(): string /** * Get image allow max width. + * * @return string */ protected function getAllowImageMaxWidth(): string @@ -89,6 +94,7 @@ protected function getAllowImageMaxWidth(): string /** * Get image allow min height. + * * @return string */ protected function getAllowImageMinHeight(): string @@ -98,6 +104,7 @@ protected function getAllowImageMinHeight(): string /** * Get image allow max height. + * * @return string */ protected function getAllowImageMaxHeight(): string @@ -107,6 +114,7 @@ protected function getAllowImageMaxHeight(): string /** * Get allow min file size. + * * @return string */ protected function getAllowMinSize(): string @@ -116,6 +124,7 @@ protected function getAllowMinSize(): string /** * Get allow max file size. + * * @return string */ protected function getAllowMaxSize(): string @@ -125,6 +134,7 @@ protected function getAllowMaxSize(): string /** * Get allow mime types. + * * @return string */ protected function getAllowMimeTypes(): string diff --git a/app/FileStorage/Validators/Rulers/FileStorageRuler.php b/app/FileStorage/Validators/Rulers/FileStorageRuler.php index db2e67db5..e5a596677 100644 --- a/app/FileStorage/Validators/Rulers/FileStorageRuler.php +++ b/app/FileStorage/Validators/Rulers/FileStorageRuler.php @@ -47,7 +47,6 @@ public function __construct(StorageInterface $storage) * Rule handler. * * @param array $params - * * @return bool */ public function handle(array $params): bool diff --git a/app/FileStorage/Validators/Rulers/RulerInterface.php b/app/FileStorage/Validators/Rulers/RulerInterface.php index 21c5d1f6c..5c5fe6166 100644 --- a/app/FileStorage/Validators/Rulers/RulerInterface.php +++ b/app/FileStorage/Validators/Rulers/RulerInterface.php @@ -24,7 +24,8 @@ interface RulerInterface { /** * Rule handler. - * @param array $params + * + * @param array $params * @return bool */ public function handle(array $params): bool; diff --git a/app/Http/Controllers/APIs/V2/AdvertisingController.php b/app/Http/Controllers/APIs/V2/AdvertisingController.php index d4c169316..89ee48bef 100644 --- a/app/Http/Controllers/APIs/V2/AdvertisingController.php +++ b/app/Http/Controllers/APIs/V2/AdvertisingController.php @@ -31,7 +31,8 @@ class AdvertisingController extends Controller * Get installed ad slot information. * * @author bs<414606094@qq.com> - * @param AdvertisingSpace $space + * + * @param AdvertisingSpace $space * @return mix */ public function index(AdvertisingSpace $space): JsonResponse @@ -45,8 +46,9 @@ public function index(AdvertisingSpace $space): JsonResponse * 查询某一广告位的广告列表. * * @author bs<414606094@qq.com> - * @param Request $request - * @param AdvertisingSpace $space + * + * @param Request $request + * @param AdvertisingSpace $space * @return mix */ public function advertising(AdvertisingSpace $space) @@ -62,7 +64,8 @@ public function advertising(AdvertisingSpace $space) * 批量获取广告列表. * * @author bs<414606094@qq.com> - * @param Request $request + * + * @param Request $request * @return json */ public function batch(Request $request, Advertising $advertisingModel) diff --git a/app/Http/Controllers/APIs/V2/AuthController.php b/app/Http/Controllers/APIs/V2/AuthController.php index 59118bdb8..737ae690e 100644 --- a/app/Http/Controllers/APIs/V2/AuthController.php +++ b/app/Http/Controllers/APIs/V2/AuthController.php @@ -54,8 +54,8 @@ public function guard(): Guard * Get a JWT token via given credentials. * * @param \Illuminate\Http\Request $request - * * @return \Illuminate\Http\JsonResponse + * * @author Seven Du */ public function login(Request $request): JsonResponse @@ -124,6 +124,7 @@ public function login(Request $request): JsonResponse * Log the user out (Invalidate the token). * * @return \Illuminate\Http\JsonResponse + * * @author Seven Du */ public function logout(): JsonResponse @@ -137,6 +138,7 @@ public function logout(): JsonResponse * Refresh a token. * * @return \Illuminate\Http\JsonResponse + * * @author Seven Du */ public function refresh(): JsonResponse @@ -150,7 +152,6 @@ public function refresh(): JsonResponse * Get the token array structure. * * @param string $token - * * @return \Illuminate\Http\JsonResponse */ protected function respondWithToken(string $token): JsonResponse diff --git a/app/Http/Controllers/APIs/V2/BootstrappersController.php b/app/Http/Controllers/APIs/V2/BootstrappersController.php index 0d12b7a9c..d312d073c 100644 --- a/app/Http/Controllers/APIs/V2/BootstrappersController.php +++ b/app/Http/Controllers/APIs/V2/BootstrappersController.php @@ -35,7 +35,6 @@ class BootstrappersController extends Controller * * @param BootstrapAPIsEventer $events * @param AdvertisingSpace $space - * * @return JsonResponse */ public function show(BootstrapAPIsEventer $events, AdvertisingSpace $space): JsonResponse @@ -121,7 +120,8 @@ public function show(BootstrapAPIsEventer $events, AdvertisingSpace $space): Jso /** * Filter null. - * @param array $data + * + * @param array $data * @return array */ protected function filterNull(array $data): array @@ -150,8 +150,9 @@ protected function filterNull(array $data): array /** * 格式化数据. * - * @param string $value + * @param string $value * @return mixed + * * @author Seven Du */ protected function formatValue(string $value) diff --git a/app/Http/Controllers/APIs/V2/Controller.php b/app/Http/Controllers/APIs/V2/Controller.php index 15e51ad1d..43c94467e 100644 --- a/app/Http/Controllers/APIs/V2/Controller.php +++ b/app/Http/Controllers/APIs/V2/Controller.php @@ -32,9 +32,10 @@ class Controller extends BaseController /** * The app function alise. * - * @param string|null $abstract - * @param array $parameters + * @param string|null $abstract + * @param array $parameters * @return mixed|\Illuminate\Foundation\Application + * * @author Seven Du */ protected function app($abstract = null, array $parameters = []) @@ -45,10 +46,11 @@ protected function app($abstract = null, array $parameters = []) /** * The response function alise. * - * @param string $content - * @param int $status - * @param array $headers + * @param string $content + * @param int $status + * @param array $headers * @return \Symfony\Component\HttpFoundation\Response|\Illuminate\Contracts\Routing\ResponseFactory + * * @author Seven Du */ protected function response(...$arguments) @@ -59,9 +61,10 @@ protected function response(...$arguments) /** * The request function alise. * - * @param array|string $key - * @param mixed $default + * @param array|string $key + * @param mixed $default * @return \Illuminate\Http\Request|string|array + * * @author Seven Du */ protected function request($key = null, $default = null) diff --git a/app/Http/Controllers/APIs/V2/CurrencyApplePayController.php b/app/Http/Controllers/APIs/V2/CurrencyApplePayController.php index e210b32f0..277600310 100644 --- a/app/Http/Controllers/APIs/V2/CurrencyApplePayController.php +++ b/app/Http/Controllers/APIs/V2/CurrencyApplePayController.php @@ -31,8 +31,9 @@ class CurrencyApplePayController extends Controller /** * 发起充值订单. * - * @param StoreCurrencyAppleIAPRecharge $request + * @param StoreCurrencyAppleIAPRecharge $request * @return mixed + * * @author BS <414606094@qq.com> */ public function store(StoreCurrencyAppleIAPRecharge $request) @@ -52,9 +53,10 @@ public function store(StoreCurrencyAppleIAPRecharge $request) /** * 主动取回凭据. * - * @param Request $request - * @param CurrencyOrderModel $currencyOrder + * @param Request $request + * @param CurrencyOrderModel $currencyOrder * @return mixed + * * @author BS <414606094@qq.com> */ public function retrieve(Request $request, CurrencyOrderModel $order) @@ -72,8 +74,9 @@ public function retrieve(Request $request, CurrencyOrderModel $order) /** * apple商品列表. * - * @param CommonConfig $config + * @param CommonConfig $config * @return mixed + * * @author BS <414606094@qq.com> */ public function productList(CommonConfig $config) diff --git a/app/Http/Controllers/APIs/V2/CurrencyCashController.php b/app/Http/Controllers/APIs/V2/CurrencyCashController.php index 97ff8ac4d..c13238cc5 100644 --- a/app/Http/Controllers/APIs/V2/CurrencyCashController.php +++ b/app/Http/Controllers/APIs/V2/CurrencyCashController.php @@ -28,8 +28,9 @@ class CurrencyCashController extends Controller /** * 发起提现订单. * - * @param StoreCurrencyCash $request + * @param StoreCurrencyCash $request * @return mixed + * * @author BS <414606094@qq.com> */ public function store(StoreCurrencyCash $request) diff --git a/app/Http/Controllers/APIs/V2/CurrencyPayController.php b/app/Http/Controllers/APIs/V2/CurrencyPayController.php index d7fd98caf..848c21058 100644 --- a/app/Http/Controllers/APIs/V2/CurrencyPayController.php +++ b/app/Http/Controllers/APIs/V2/CurrencyPayController.php @@ -62,9 +62,9 @@ public function entry(Request $request, ApplicationContract $app, ResponseContra } /** - * @param Request $request - * @param Carbon $dateTime - * @param Response $response + * @param Request $request + * @param Carbon $dateTime + * @param Response $response * @return \Illuminate\Http\JsonResponse */ public function getAlipayOrder(Request $request, ResponseFactory $response, NativePayOrder $order) @@ -393,9 +393,9 @@ public function getWechatOrder(Request $request, ResponseFactory $response, Nati } /** - * @param Request $request - * @param Carbon $dateTime - * @param Response $response + * @param Request $request + * @param Carbon $dateTime + * @param Response $response * @return \Illuminate\Http\JsonResponse */ public function getWechatWapOrder(Request $request, ResponseFactory $response, NativePayOrder $order) diff --git a/app/Http/Controllers/APIs/V2/CurrencyRechargeController.php b/app/Http/Controllers/APIs/V2/CurrencyRechargeController.php index 2b96eb4b1..14ee30af9 100644 --- a/app/Http/Controllers/APIs/V2/CurrencyRechargeController.php +++ b/app/Http/Controllers/APIs/V2/CurrencyRechargeController.php @@ -30,9 +30,10 @@ class CurrencyRechargeController extends Controller /** * 钱包流水. * - * @param Request $request - * @param CurrencyOrderModel $currencyOrder + * @param Request $request + * @param CurrencyOrderModel $currencyOrder * @return mixed + * * @author BS <414606094@qq.com> */ public function index(Request $request, CurrencyOrderModel $currencyOrder) @@ -64,8 +65,9 @@ public function index(Request $request, CurrencyOrderModel $currencyOrder) /** * 发起充值订单. * - * @param StoreCurrencyRecharge $request + * @param StoreCurrencyRecharge $request * @return mixed + * * @author BS <414606094@qq.com> */ public function store(StoreCurrencyRecharge $request) @@ -87,8 +89,9 @@ public function store(StoreCurrencyRecharge $request) /** * 充值回调通知. * - * @param Request $request + * @param Request $request * @return mixed + * * @author BS <414606094@qq.com> */ public function webhook(Request $request) @@ -104,8 +107,9 @@ public function webhook(Request $request) /** * 主动取回凭据. * - * @param CurrencyOrderModel &$currencyOrder + * @param CurrencyOrderModel &$currencyOrder * @return mixed + * * @author BS <414606094@qq.com> */ public function retrieve(CurrencyOrderModel $order) diff --git a/app/Http/Controllers/APIs/V2/CurrentUserController.php b/app/Http/Controllers/APIs/V2/CurrentUserController.php index 2337eab0e..85ce071bf 100644 --- a/app/Http/Controllers/APIs/V2/CurrentUserController.php +++ b/app/Http/Controllers/APIs/V2/CurrentUserController.php @@ -31,9 +31,10 @@ class CurrentUserController extends Controller /** * Get a single user. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function show(Request $request, ResponseFactoryContract $response) @@ -52,9 +53,10 @@ public function show(Request $request, ResponseFactoryContract $response) /** * Update the authenticated user. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function update(Request $request, ResponseFactoryContract $response) @@ -102,10 +104,11 @@ public function update(Request $request, ResponseFactoryContract $response) /** * Update phone or email of the authenticated user. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\VerificationCode $model + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\VerificationCode $model * @return mixed + * * @author Seven Du */ public function updatePhoneOrMail(Request $request, ResponseFactoryContract $response, VerificationCodeModel $model) @@ -156,9 +159,10 @@ public function updatePhoneOrMail(Request $request, ResponseFactoryContract $res /** * Show user followers. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function followers(Request $request, ResponseFactoryContract $response) @@ -187,9 +191,10 @@ public function followers(Request $request, ResponseFactoryContract $response) /** * Show user followings. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function followings(Request $request, ResponseFactoryContract $response) @@ -218,10 +223,11 @@ public function followings(Request $request, ResponseFactoryContract $response) /** * Attach a following user. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\User $target + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\User $target * @return mixed + * * @author Seven Du */ public function attachFollowingUser(Request $request, UserModel $target) @@ -248,9 +254,10 @@ public function attachFollowingUser(Request $request, UserModel $target) /** * detach a following user. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Plus\Models\User $target + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Plus\Models\User $target * @return mixed + * * @author Seven Du */ public function detachFollowingUser(Request $request, UserModel $target) @@ -268,9 +275,10 @@ public function detachFollowingUser(Request $request, UserModel $target) /** * 获取授权用户相互关注的用户列表. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author ZsyD<1251992018@qq.com> */ public function followMutual(Request $request, ResponseFactoryContract $response) diff --git a/app/Http/Controllers/APIs/V2/FilesController.php b/app/Http/Controllers/APIs/V2/FilesController.php index 5177d9910..7fcd5639e 100644 --- a/app/Http/Controllers/APIs/V2/FilesController.php +++ b/app/Http/Controllers/APIs/V2/FilesController.php @@ -39,11 +39,12 @@ class FilesController extends Controller /** * Get file. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param CdnUrlManager $cdn - * @param \Zhiyi\Plus\Models\FileWith $fileWith + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param CdnUrlManager $cdn + * @param \Zhiyi\Plus\Models\FileWith $fileWith * @return mixed + * * @author Seven Du */ public function show(Request $request, ResponseContract $response, CdnUrlManager $cdn, FileWithModel $fileWith) @@ -76,9 +77,10 @@ public function show(Request $request, ResponseContract $response, CdnUrlManager /** * 解决用户是否购买过处理. * - * @param \Zhiyi\Plus\Models\User|null $user - * @param PaidNodeModel $node + * @param \Zhiyi\Plus\Models\User|null $user + * @param PaidNodeModel $node * @return bool + * * @author Seven Du */ protected function resolveUserPaid($user, PaidNodeModel $node): bool @@ -89,12 +91,13 @@ protected function resolveUserPaid($user, PaidNodeModel $node): bool /** * 储存上传文件. * - * @param \Zhiyi\Plus\Http\Requests\API2\StoreUploadFile $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Carbon\Carbon $dateTime - * @param \Zhiyi\Plus\Models\File $fileModel - * @param \Zhiyi\Plus\Models\FileWith $fileWith + * @param \Zhiyi\Plus\Http\Requests\API2\StoreUploadFile $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Carbon\Carbon $dateTime + * @param \Zhiyi\Plus\Models\File $fileModel + * @param \Zhiyi\Plus\Models\FileWith $fileWith * @return mixed + * * @author Seven Du */ public function store(StoreUploadFileRequest $request, ResponseContract $response, Carbon $dateTime, FileModel $fileModel, FileWithModel $fileWith) @@ -134,12 +137,13 @@ public function store(StoreUploadFileRequest $request, ResponseContract $respons /** * Get or create a uploaded file with id. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\File $file - * @param \Zhiyi\Plus\Models\FileWith $fileWith - * @param string $hash + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\File $file + * @param \Zhiyi\Plus\Models\FileWith $fileWith + * @param string $hash * @return mixed + * * @author Seven Du */ public function uploaded(Request $request, ResponseContract $response, FileModel $file, FileWithModel $fileWith, string $hash) @@ -160,10 +164,11 @@ public function uploaded(Request $request, ResponseContract $response, FileModel /** * Validate and return the file database model instance. * - * @param \Zhiyi\Plus\Models\File $fileModel - * @param \Illuminate\Http\UploadedFile $file - * @param callable $call + * @param \Zhiyi\Plus\Models\File $fileModel + * @param \Illuminate\Http\UploadedFile $file + * @param callable $call * @return \Zhiyi\Plus\Models\File + * * @author Seven Du */ protected function validateFileInDatabase(FileModel $fileModel, UploadedFile $file, callable $call): FileModel @@ -178,10 +183,11 @@ protected function validateFileInDatabase(FileModel $fileModel, UploadedFile $fi /** * 解决数据模型非实例. * - * @param \Zhiyi\Plus\Models\FileWith $fileWith - * @param \Zhiyi\Plus\Models\User $user - * @param \Zhiyi\Plus\Models\File $file + * @param \Zhiyi\Plus\Models\FileWith $fileWith + * @param \Zhiyi\Plus\Models\User $user + * @param \Zhiyi\Plus\Models\File $file * @return \Zhiyi\Plus\Models\FileWith + * * @author Seven Du */ protected function resolveFileWith(FileWithModel $fileWith, UserModel $user, FileModel $file): FileWithModel diff --git a/app/Http/Controllers/APIs/V2/LocationController.php b/app/Http/Controllers/APIs/V2/LocationController.php index 2a9daed7d..4fafd1c75 100644 --- a/app/Http/Controllers/APIs/V2/LocationController.php +++ b/app/Http/Controllers/APIs/V2/LocationController.php @@ -30,10 +30,11 @@ class LocationController extends Controller /** * Search locations. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\Area $model + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\Area $model * @return mixed + * * @author Seven Du */ public function search(Request $request, ResponseFactoryContract $response, AreaModel $model) @@ -72,7 +73,8 @@ public function search(Request $request, ResponseFactoryContract $response, Area * 获取热门城市列表. * * @author bs<414606094@qq.com> - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed */ public function hots(ResponseFactoryContract $response, ConfigModel $configMModel) diff --git a/app/Http/Controllers/APIs/V2/NewUserRewardController.php b/app/Http/Controllers/APIs/V2/NewUserRewardController.php index bb5ceee19..a477f5019 100644 --- a/app/Http/Controllers/APIs/V2/NewUserRewardController.php +++ b/app/Http/Controllers/APIs/V2/NewUserRewardController.php @@ -49,7 +49,6 @@ public function __construct() * @param Request $request * @param User $target * @param UserProcess $processer - * * @return JsonResponse */ public function store(Request $request, User $target, UserProcess $processer) diff --git a/app/Http/Controllers/APIs/V2/NewWalletCashController.php b/app/Http/Controllers/APIs/V2/NewWalletCashController.php index e5b97b863..1604b0308 100644 --- a/app/Http/Controllers/APIs/V2/NewWalletCashController.php +++ b/app/Http/Controllers/APIs/V2/NewWalletCashController.php @@ -31,8 +31,9 @@ class NewWalletCashController extends Controller /** * 获取提现列表. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return mixed + * * @author BS <414606094@qq.com> */ public function show(Request $request) @@ -58,8 +59,9 @@ public function show(Request $request) /** * 提交提现申请. * - * @param \Zhiyi\Plus\Http\Requests\API2\NewStoreUserWallerCashPost $request + * @param \Zhiyi\Plus\Http\Requests\API2\NewStoreUserWallerCashPost $request * @return mixed + * * @author BS <414606094@qq.com> */ public function store(NewStoreUserWallerCashPost $request, TypeManager $manager) diff --git a/app/Http/Controllers/APIs/V2/NewWalletRechargeController.php b/app/Http/Controllers/APIs/V2/NewWalletRechargeController.php index c28141c84..fb257af00 100644 --- a/app/Http/Controllers/APIs/V2/NewWalletRechargeController.php +++ b/app/Http/Controllers/APIs/V2/NewWalletRechargeController.php @@ -37,9 +37,10 @@ class NewWalletRechargeController extends Controller /** * 钱包流水列表. * - * @param Request $request - * @param WalletOrderModel $walletOrderModel + * @param Request $request + * @param WalletOrderModel $walletOrderModel * @return mixed + * * @author BS <414606094@qq.com> */ public function list(Request $request, WalletOrderModel $walletOrderModel) @@ -65,9 +66,10 @@ public function list(Request $request, WalletOrderModel $walletOrderModel) /** * 创建充值订单. * - * @param NewStoreWalletRecharge $request - * @param TypeManager $manager + * @param NewStoreWalletRecharge $request + * @param TypeManager $manager * @return mixed + * * @author BS <414606094@qq.com> */ public function store(NewStoreWalletRecharge $request, TypeManager $manager) @@ -87,9 +89,10 @@ public function store(NewStoreWalletRecharge $request, TypeManager $manager) /** * 充值回调通知. * - * @param Request $request - * @param TypeManager $manager + * @param Request $request + * @param TypeManager $manager * @return mixed + * * @author BS <414606094@qq.com> */ public function webhook(Request $request, TypeManager $manager) @@ -104,8 +107,9 @@ public function webhook(Request $request, TypeManager $manager) /** * 主动取回凭据. * - * @param WalletOrderModel $walletOrder + * @param WalletOrderModel $walletOrder * @return mixed + * * @author BS <414606094@qq.com> */ public function retrieve(WalletOrderModel $order, TypeManager $manager) @@ -120,9 +124,10 @@ public function retrieve(WalletOrderModel $order, TypeManager $manager) /** * 创建转换积分订单. * - * @param Request $request - * @param TypeManager $manager + * @param Request $request + * @param TypeManager $manager * @return mixed + * * @author BS <414606094@qq.com> */ public function transform(StoreTransform $request, TypeManager $manager) diff --git a/app/Http/Controllers/APIs/V2/PayController.php b/app/Http/Controllers/APIs/V2/PayController.php index 91d8714fb..2ea674cf8 100644 --- a/app/Http/Controllers/APIs/V2/PayController.php +++ b/app/Http/Controllers/APIs/V2/PayController.php @@ -50,9 +50,9 @@ public function entry(Request $request, ApplicationContract $app, ResponseContra } /** - * @param Request $request - * @param Carbon $dateTime - * @param Response $response + * @param Request $request + * @param Carbon $dateTime + * @param Response $response * @return \Illuminate\Http\JsonResponse */ public function getAlipayOrder(Request $request, ResponseFactory $response, NativePayOrder $order) @@ -402,9 +402,9 @@ public function getWechatOrder(Request $request, ResponseFactory $response, Nati } /** - * @param Request $request - * @param ResponseContract $response - * @param NativePayOrder $order + * @param Request $request + * @param ResponseContract $response + * @param NativePayOrder $order * @return \Illuminate\Http\JsonResponse */ public function getWechatWapOrder(Request $request, ResponseFactory $response, NativePayOrder $order) diff --git a/app/Http/Controllers/APIs/V2/PingPlusPlusChargeWebHooks.php b/app/Http/Controllers/APIs/V2/PingPlusPlusChargeWebHooks.php index 345024a67..f6b45dbee 100644 --- a/app/Http/Controllers/APIs/V2/PingPlusPlusChargeWebHooks.php +++ b/app/Http/Controllers/APIs/V2/PingPlusPlusChargeWebHooks.php @@ -69,9 +69,10 @@ public function webhook(Request $request, ChargeService $chargeService) /** * 解决付款订单来源. * - * @param array $charge - * @param string|null $default + * @param array $charge + * @param string|null $default * @return string|null + * * @author Seven Du */ protected function resolveChargeAccount($charge, $default = null) diff --git a/app/Http/Controllers/APIs/V2/PurchaseController.php b/app/Http/Controllers/APIs/V2/PurchaseController.php index 006aab2de..935d32f93 100644 --- a/app/Http/Controllers/APIs/V2/PurchaseController.php +++ b/app/Http/Controllers/APIs/V2/PurchaseController.php @@ -44,10 +44,11 @@ public function __construct() /** * 获取付费节点和当前用户的付费状态. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\PaidNode $node + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\PaidNode $node * @return mixed + * * @author Seven Du */ public function show(Request $request, ResponseContract $response, PaidNodeModel $node) @@ -62,12 +63,13 @@ public function show(Request $request, ResponseContract $response, PaidNodeModel /** * 支付节点费用. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Illuminate\Contracts\Cache\Repository $cache - * @param \Zhiyi\Plus\Models\WalletCharge $charge - * @param \Zhiyi\Plus\Models\PaidNode $node + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Contracts\Cache\Repository $cache + * @param \Zhiyi\Plus\Models\WalletCharge $charge + * @param \Zhiyi\Plus\Models\PaidNode $node * @return mixed + * * @author Seven Du */ public function pay(Request $request, ResponseContract $response, CacheContract $cache, WalletChargeModel $charge, PaidNodeModel $node) @@ -153,10 +155,11 @@ public function pay(Request $request, ResponseContract $response, CacheContract /** * 使用积分购买付费节点. * - * @param Request $request - * @param CacheContract $cache - * @param PaidNodeModel $node + * @param Request $request + * @param CacheContract $cache + * @param PaidNodeModel $node * @return mixed + * * @author BS <414606094@qq.com> */ public function payByCurrency(Request $request, CacheContract $cache, PaidNodeModel $node) diff --git a/app/Http/Controllers/APIs/V2/RankController.php b/app/Http/Controllers/APIs/V2/RankController.php index 18805fdfb..bbf6c3564 100644 --- a/app/Http/Controllers/APIs/V2/RankController.php +++ b/app/Http/Controllers/APIs/V2/RankController.php @@ -30,8 +30,9 @@ class RankController extends Controller * Get the full rank of user who has more followers. * * @author bs<414606094@qq.com> - * @param Illuminate\Http\Request $request - * @param Zhiyi\Plus\Models\User $userModel + * + * @param Illuminate\Http\Request $request + * @param Zhiyi\Plus\Models\User $userModel * @return mixed */ public function followers(Request $request, User $userModel) @@ -69,8 +70,9 @@ public function followers(Request $request, User $userModel) * Get the total fortune ranking. * * @author bs<414606094@qq.com> - * @param Illuminate\Http\Request $request - * @param Zhiyi\Plus\Models\User $userModel + * + * @param Illuminate\Http\Request $request + * @param Zhiyi\Plus\Models\User $userModel * @return mixed */ public function balance(Request $request, User $userModel) @@ -106,8 +108,9 @@ public function balance(Request $request, User $userModel) * Get the rank of user`s income. * * @author bs<414606094@qq.com> - * @param Illuminate\Http\Request $request - * @param Zhiyi\Plus\Models\User $userModel + * + * @param Illuminate\Http\Request $request + * @param Zhiyi\Plus\Models\User $userModel * @return mixed */ public function income(Request $request, User $userModel) diff --git a/app/Http/Controllers/APIs/V2/ReportController.php b/app/Http/Controllers/APIs/V2/ReportController.php index 91b85ef55..0800c8b1a 100644 --- a/app/Http/Controllers/APIs/V2/ReportController.php +++ b/app/Http/Controllers/APIs/V2/ReportController.php @@ -30,10 +30,11 @@ class ReportController extends Controller /** * 举报一个用户. * - * @param Request $request - * @param UserModel $user - * @param ReportModel $reportModel + * @param Request $request + * @param UserModel $user + * @param ReportModel $reportModel * @return mixed + * * @author BS <414606094@qq.com> */ public function user(Request $request, UserModel $user, ReportModel $reportModel) @@ -54,10 +55,11 @@ public function user(Request $request, UserModel $user, ReportModel $reportModel /** * 举报一条评论. * - * @param Request $request - * @param CommentModel $comment - * @param ReportModel $reportModel + * @param Request $request + * @param CommentModel $comment + * @param ReportModel $reportModel * @return mixed + * * @author BS <414606094@qq.com> */ public function comment(Request $request, CommentModel $comment, ReportModel $reportModel) diff --git a/app/Http/Controllers/APIs/V2/ResetPasswordController.php b/app/Http/Controllers/APIs/V2/ResetPasswordController.php index cda597bc6..6076b0675 100644 --- a/app/Http/Controllers/APIs/V2/ResetPasswordController.php +++ b/app/Http/Controllers/APIs/V2/ResetPasswordController.php @@ -31,9 +31,10 @@ class ResetPasswordController extends Controller /** * Reset password. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function reset(Request $request, ResponseFactoryContract $response) @@ -67,6 +68,7 @@ public function reset(Request $request, ResponseFactoryContract $response) * Get reset validateion rules. * * @return array + * * @author Seven Du */ protected function resetRules(): array @@ -81,6 +83,7 @@ protected function resetRules(): array * Get reset validation error messages. * * @return array + * * @author Seven Du */ protected function resetValidationErrorMessages(): array @@ -99,7 +102,8 @@ protected function resetValidationErrorMessages(): array * Set new password. * * @author bs<414606094@qq.com> - * @param Request $request + * + * @param Request $request * @param User $user */ public function setPassword(Request $request, UserModel $user) @@ -117,11 +121,12 @@ public function setPassword(Request $request, UserModel $user) /** * Retrueve user password. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\VerificationCode $verificationCodeModel - * @param \Zhiyi\Plus\Models\User $userModel + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\VerificationCode $verificationCodeModel + * @param \Zhiyi\Plus\Models\User $userModel * @return mixed + * * @author Seven Du */ public function retrieve(Request $request, diff --git a/app/Http/Controllers/APIs/V2/SystemController.php b/app/Http/Controllers/APIs/V2/SystemController.php index d7883ce39..9ee721d54 100644 --- a/app/Http/Controllers/APIs/V2/SystemController.php +++ b/app/Http/Controllers/APIs/V2/SystemController.php @@ -32,7 +32,8 @@ class SystemController extends Controller * create a feedback. * * @author bs<414606094@qq.com> - * @param Request $request + * + * @param Request $request * @return mixed */ public function createFeedback(Request $request, Conversation $feedback, Carbon $datetime) @@ -53,6 +54,7 @@ public function createFeedback(Request $request, Conversation $feedback, Carbon * about us. * * @author bs<414606094@qq.com> + * * @return html */ public function about() @@ -71,6 +73,7 @@ public function about() * 注册协议. * * @author Foreach<791477842@qq.com> + * * @return html */ public function agreement(Markdown $markdown) @@ -87,8 +90,9 @@ public function agreement(Markdown $markdown) * 获取系统会话列表. * * @author bs<414606094@qq.com> - * @param Request $request - * @param Conversation $conversationModel + * + * @param Request $request + * @param Conversation $conversationModel * @return mixed */ public function getConversations(Request $request, Conversation $conversationModel) diff --git a/app/Http/Controllers/APIs/V2/TagController.php b/app/Http/Controllers/APIs/V2/TagController.php index 79c1b10fc..813f2ac3a 100644 --- a/app/Http/Controllers/APIs/V2/TagController.php +++ b/app/Http/Controllers/APIs/V2/TagController.php @@ -28,9 +28,10 @@ class TagController extends Controller /** * Get all tags. * - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\TagCategory $categoryModel + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\TagCategory $categoryModel * @return mixed + * * @author Seven Du */ public function index(ResponseFactoryContract $response, TagCategoryModel $categoryModel) diff --git a/app/Http/Controllers/APIs/V2/TagUserController.php b/app/Http/Controllers/APIs/V2/TagUserController.php index b06dac8bc..4679f7254 100644 --- a/app/Http/Controllers/APIs/V2/TagUserController.php +++ b/app/Http/Controllers/APIs/V2/TagUserController.php @@ -30,9 +30,10 @@ class TagUserController extends Controller /** * Get all tags of the authenticated user. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function index(Request $request, ResponseFactoryContract $response) @@ -43,10 +44,11 @@ public function index(Request $request, ResponseFactoryContract $response) /** * Attach a tag for the authenticated user. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\Tag $tag + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\Tag $tag * @return mixed + * * @author Seven Du */ public function store(Request $request, ResponseFactoryContract $response, TagModel $tag) @@ -70,10 +72,11 @@ public function store(Request $request, ResponseFactoryContract $response, TagMo /** * Detach a tag for the authenticated user. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\Tag $tag + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\Tag $tag * @return mixed + * * @author Seven Du */ public function destroy(Request $request, ResponseFactoryContract $response, TagModel $tag) @@ -98,9 +101,10 @@ public function destroy(Request $request, ResponseFactoryContract $response, Tag /** * Get the user's tags. * - * @param \Illuminate\Contracts\Routing\ResponseFactory $response [description] - * @param \Zhiyi\Plus\Models\User $user [description] + * @param \Illuminate\Contracts\Routing\ResponseFactory $response [description] + * @param \Zhiyi\Plus\Models\User $user [description] * @return mixed + * * @author Seven Du */ public function userTgas(ResponseFactoryContract $response, int $user) diff --git a/app/Http/Controllers/APIs/V2/TransferController.php b/app/Http/Controllers/APIs/V2/TransferController.php index 02234b1cf..7797f977b 100644 --- a/app/Http/Controllers/APIs/V2/TransferController.php +++ b/app/Http/Controllers/APIs/V2/TransferController.php @@ -29,9 +29,10 @@ class TransferController extends Controller /** * 用户之间转账. * - * @param TransferRequest $request - * @param TypeManager $manager + * @param TransferRequest $request + * @param TypeManager $manager * @return mixed + * * @author BS <414606094@qq.com> */ public function transfer(TransferRequest $request, TypeManager $manager) diff --git a/app/Http/Controllers/APIs/V2/UserBlacklistController.php b/app/Http/Controllers/APIs/V2/UserBlacklistController.php index 952503a08..5317c99d7 100644 --- a/app/Http/Controllers/APIs/V2/UserBlacklistController.php +++ b/app/Http/Controllers/APIs/V2/UserBlacklistController.php @@ -58,12 +58,14 @@ public function black(Request $request, UserModel $targetUser, UserBlacklistMode /** * 移出黑名单. + * * @Author Wayne * @DateTime 2018-04-17 * @Email qiaobin@zhiyicx.com - * @param Request $request [description] - * @param UserModel $user [description] - * @return [type] [description] + * + * @param Request $request [description] + * @param UserModel $user [description] + * @return [type] [description] */ public function unBlack(Request $request, UserModel $targetUser, UserBlacklistModel $blackList) { @@ -82,11 +84,13 @@ public function unBlack(Request $request, UserModel $targetUser, UserBlacklistMo /** * black list of current user. + * * @Author Wayne * @DateTime 2018-04-18 * @Email qiaobin@zhiyicx.com - * @param Request $request [description] - * @return [type] [description] + * + * @param Request $request [description] + * @return [type] [description] */ public function blackList(Request $request) { diff --git a/app/Http/Controllers/APIs/V2/UserCertificationController.php b/app/Http/Controllers/APIs/V2/UserCertificationController.php index 6190eb47e..c5b9019be 100644 --- a/app/Http/Controllers/APIs/V2/UserCertificationController.php +++ b/app/Http/Controllers/APIs/V2/UserCertificationController.php @@ -32,9 +32,10 @@ class UserCertificationController extends Controller /** * Get a user certification. * - * @param \Illuminate\Http\Request $request [description] - * @param \Illuminate\Contracts\Routing\ResponseFactory $response [description] + * @param \Illuminate\Http\Request $request [description] + * @param \Illuminate\Contracts\Routing\ResponseFactory $response [description] * @return mixed + * * @author Seven Du */ public function show(Request $request, ResponseFactoryContract $response) @@ -61,11 +62,12 @@ public function show(Request $request, ResponseFactoryContract $response) /** * Send certification. * - * @param \Zhiyi\Plus\Http\Requests\API2\UserCertification $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\Certification $certification - * @param \Zhiyi\Plus\Models\FileWith $fileWithModel + * @param \Zhiyi\Plus\Http\Requests\API2\UserCertification $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\Certification $certification + * @param \Zhiyi\Plus\Models\FileWith $fileWithModel * @return mixed + * * @author Seven Du */ public function store( @@ -103,10 +105,11 @@ public function store( /** * Update certification. * - * @param \Zhiyi\Plus\Http\Requests\API2\UserCertification $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\FileWith $fileWithModel + * @param \Zhiyi\Plus\Http\Requests\API2\UserCertification $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\FileWith $fileWithModel * @return mixed + * * @author Seven Du */ public function update( @@ -155,9 +158,10 @@ public function update( /** * File not with file models. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Plus\Models\FileWith $fileWithModel + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Plus\Models\FileWith $fileWithModel * @return \Illuminate\Support\Collection + * * @author Seven Du */ protected function findNotWithFileModels(Request $request, FileWithModel $fileWithModel): Collection diff --git a/app/Http/Controllers/APIs/V2/UserCommentController.php b/app/Http/Controllers/APIs/V2/UserCommentController.php index cad385dab..ac5ada253 100644 --- a/app/Http/Controllers/APIs/V2/UserCommentController.php +++ b/app/Http/Controllers/APIs/V2/UserCommentController.php @@ -29,10 +29,11 @@ class UserCommentController extends Controller /** * Get user comments. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\Comment $model + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\Comment $model * @return mixed + * * @author Seven Du */ public function index(Request $request, ResponseContract $response, CommentModel $model) diff --git a/app/Http/Controllers/APIs/V2/UserController.php b/app/Http/Controllers/APIs/V2/UserController.php index 55c2865e8..a4feca235 100644 --- a/app/Http/Controllers/APIs/V2/UserController.php +++ b/app/Http/Controllers/APIs/V2/UserController.php @@ -40,9 +40,10 @@ class UserController extends Controller * @param Request $request * @param ResponseFactoryContract $response * @param User $model - * * @return mixed + * * @throws Throwable + * * @author Seven Du */ public function index( @@ -114,8 +115,8 @@ function ($query) use ($tags) { * * @param Request $request * @param string $user - * * @return mixed + * * @author Seven Du */ public function show(Request $request, string $user) @@ -149,8 +150,8 @@ public function show(Request $request, string $user) * @param StoreUserPost $request * @param ResponseFactoryContract $response * @param JWTAuth $auth - * * @return mixed + * * @author Seven Du */ public function store( @@ -209,9 +210,9 @@ public function store( * Handle the state of my follow status. * * @param Request $request - * @param User &$user - * + * @param User &$user * @return void + * * @author Seven Du */ protected function hasFollowing(Request $request, User &$user) @@ -226,9 +227,9 @@ protected function hasFollowing(Request $request, User &$user) * Verify that I am followed. * * @param Request $request - * @param User &$user - * + * @param User &$user * @return void + * * @author Seven Du */ protected function hasFollower(Request $request, User &$user) diff --git a/app/Http/Controllers/APIs/V2/UserEmailController.php b/app/Http/Controllers/APIs/V2/UserEmailController.php index ff6a74126..0e40cd4f1 100644 --- a/app/Http/Controllers/APIs/V2/UserEmailController.php +++ b/app/Http/Controllers/APIs/V2/UserEmailController.php @@ -29,9 +29,10 @@ class UserEmailController extends Controller /** * 解除用户 E-Mail 绑定. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function delete(Request $request, ResponseFactoryContract $response) diff --git a/app/Http/Controllers/APIs/V2/UserFollowController.php b/app/Http/Controllers/APIs/V2/UserFollowController.php index bbefd8cca..00a024cce 100644 --- a/app/Http/Controllers/APIs/V2/UserFollowController.php +++ b/app/Http/Controllers/APIs/V2/UserFollowController.php @@ -29,10 +29,11 @@ class UserFollowController extends Controller /** * List followers of a user. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\User $user + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\User $user * @return mixed + * * @author Seven Du */ public function followers(Request $request, ResponseFactoryContract $response, UserModel $user) @@ -61,10 +62,11 @@ public function followers(Request $request, ResponseFactoryContract $response, U /** * List users followed by another user. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\User $user + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\User $user * @return mixed + * * @author Seven Du */ public function followings(Request $request, ResponseFactoryContract $response, UserModel $user) diff --git a/app/Http/Controllers/APIs/V2/UserNotificationController.php b/app/Http/Controllers/APIs/V2/UserNotificationController.php index 47aa33137..5b341b32e 100644 --- a/app/Http/Controllers/APIs/V2/UserNotificationController.php +++ b/app/Http/Controllers/APIs/V2/UserNotificationController.php @@ -31,9 +31,10 @@ class UserNotificationController extends Controller /** * Get user notifications. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function index(Request $request, ContractResponse $response) @@ -70,10 +71,11 @@ public function index(Request $request, ContractResponse $response) /** * Get notification message. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param string $notification + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param string $notification * @return mixed + * * @author Seven Du */ public function show(Request $request, ContractResponse $response, string $notification) @@ -95,10 +97,11 @@ public function show(Request $request, ContractResponse $response, string $notif /** * Mark notification status to read. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param string $notification + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param string $notification * @return mixed + * * @author Seven Du */ public function markAsRead(Request $request, ContractResponse $response, string $notification = '') @@ -124,8 +127,9 @@ public function markAsRead(Request $request, ContractResponse $response, string /** * 标记所有未读消息为已读. * - * @param Request $request + * @param Request $request * @return mixed + * * @author BS <414606094@qq.com> */ public function markAllAsRead(Request $request) diff --git a/app/Http/Controllers/APIs/V2/UserPhoneController.php b/app/Http/Controllers/APIs/V2/UserPhoneController.php index 3fcd22d89..6b772ed01 100644 --- a/app/Http/Controllers/APIs/V2/UserPhoneController.php +++ b/app/Http/Controllers/APIs/V2/UserPhoneController.php @@ -29,9 +29,10 @@ class UserPhoneController extends Controller /** * 删除用户手机号码. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function delete(Request $request, ResponseFactoryContract $response) diff --git a/app/Http/Controllers/APIs/V2/UserRewardController.php b/app/Http/Controllers/APIs/V2/UserRewardController.php index 57f849b6d..7132dd65b 100644 --- a/app/Http/Controllers/APIs/V2/UserRewardController.php +++ b/app/Http/Controllers/APIs/V2/UserRewardController.php @@ -42,9 +42,10 @@ public function __construct() * 打赏用户. * * @author bs<414606094@qq.com> - * @param Request $request - * @param User $target - * @param WalletCharge $chargeModel + * + * @param Request $request + * @param User $target + * @param WalletCharge $chargeModel * @return json */ public function store(Request $request, User $target, UserProcess $processer) diff --git a/app/Http/Controllers/APIs/V2/UserUnreadCountController.php b/app/Http/Controllers/APIs/V2/UserUnreadCountController.php index 9964ddc6d..09568d737 100644 --- a/app/Http/Controllers/APIs/V2/UserUnreadCountController.php +++ b/app/Http/Controllers/APIs/V2/UserUnreadCountController.php @@ -39,8 +39,8 @@ class UserUnreadCountController extends Controller * @param Request $request * @param CommentModel $commentModel * @param LikeModel $likeModel - * * @return mixed + * * @author BS <414606094@qq.com> */ public function index( diff --git a/app/Http/Controllers/APIs/V2/VerifyCodeController.php b/app/Http/Controllers/APIs/V2/VerifyCodeController.php index 127227355..4f7f716ee 100644 --- a/app/Http/Controllers/APIs/V2/VerifyCodeController.php +++ b/app/Http/Controllers/APIs/V2/VerifyCodeController.php @@ -30,8 +30,9 @@ class VerifyCodeController extends Controller /** * 创建注册验证码. * - * @param \Zhiyi\Plus\Http\Requests\API2\CreateRegisterVerifyCodeRequest $request + * @param \Zhiyi\Plus\Http\Requests\API2\CreateRegisterVerifyCodeRequest $request * @return mixed + * * @author Seven Du */ public function storeByRegister(CreateRegisterVerifyCodeRequest $request) @@ -42,8 +43,9 @@ public function storeByRegister(CreateRegisterVerifyCodeRequest $request) /** * 创建并发送用户验证码. * - * @param \Zhiyi\Plus\Http\Requests\API2\StoreVerifyCode $request [description] + * @param \Zhiyi\Plus\Http\Requests\API2\StoreVerifyCode $request [description] * @return mixed + * * @author Seven Du */ public function store(StoreVerifyCode $request) @@ -54,7 +56,7 @@ public function store(StoreVerifyCode $request) /** * 发送验证码通过请求 * - * @param Request $request + * @param Request $request * @return mixed */ protected function sendFromRequest(Request $request) @@ -92,6 +94,7 @@ protected function sendFromRequest(Request $request) * @param string $channel * @param array $data * @return mixed + * * @author Seven Du */ protected function send(string $account, string $channel = '', array $data = []) @@ -111,8 +114,9 @@ protected function send(string $account, string $channel = '', array $data = []) /** * Validate sent. * - * @param string $account + * @param string $account * @return void + * * @author Seven Du */ protected function validateSent(string $account) diff --git a/app/Http/Controllers/APIs/V2/WalletCashController.php b/app/Http/Controllers/APIs/V2/WalletCashController.php index d6fefa507..8963e86b8 100644 --- a/app/Http/Controllers/APIs/V2/WalletCashController.php +++ b/app/Http/Controllers/APIs/V2/WalletCashController.php @@ -31,8 +31,9 @@ class WalletCashController extends Controller /** * 获取提现列表. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return mixed + * * @author Seven Du */ public function show(Request $request) @@ -58,8 +59,9 @@ public function show(Request $request) /** * 提交提现申请. * - * @param \Zhiyi\Plus\Http\Requests\API2\StoreUserWallerCashPost $request + * @param \Zhiyi\Plus\Http\Requests\API2\StoreUserWallerCashPost $request * @return mixed + * * @author Seven Du */ public function store(StoreUserWallerCashPost $request) diff --git a/app/Http/Controllers/APIs/V2/WalletChargeController.php b/app/Http/Controllers/APIs/V2/WalletChargeController.php index 6da7a57ed..1b20d43a8 100644 --- a/app/Http/Controllers/APIs/V2/WalletChargeController.php +++ b/app/Http/Controllers/APIs/V2/WalletChargeController.php @@ -32,9 +32,10 @@ class WalletChargeController extends Controller /** * Get charges. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function list(Request $request, ContractResponse $response) @@ -67,10 +68,11 @@ public function list(Request $request, ContractResponse $response) /** * Get a charge. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\WalletCharge $charge + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\WalletCharge $charge * @return mixed + * * @author Seven Du */ public function show(Request $request, ContractResponse $response, WalletCharge $charge) @@ -92,8 +94,9 @@ public function show(Request $request, ContractResponse $response, WalletCharge /** * Retrieve charge. * - * @param \Zhiyi\Plus\Models\WalletCharge $charge + * @param \Zhiyi\Plus\Models\WalletCharge $charge * @return \Zhiyi\Plus\Models\WalletCharge + * * @author Seven Du */ protected function retrieveCharge(WalletCharge &$charge, User $user): WalletCharge @@ -130,9 +133,10 @@ protected function retrieveCharge(WalletCharge &$charge, User $user): WalletChar /** * 解决付款订单来源. * - * @param array $charge - * @param string|null $default + * @param array $charge + * @param string|null $default * @return string|null + * * @author Seven Du */ protected function resolveChargeAccount($charge, $default = null) diff --git a/app/Http/Controllers/APIs/V2/WalletConfigController.php b/app/Http/Controllers/APIs/V2/WalletConfigController.php index 38fbc0188..a43bc8fe2 100644 --- a/app/Http/Controllers/APIs/V2/WalletConfigController.php +++ b/app/Http/Controllers/APIs/V2/WalletConfigController.php @@ -58,8 +58,9 @@ class WalletConfigController extends Controller /** * Get wallet info. * - * @param ResponseFactory $response + * @param ResponseFactory $response * @return mixed + * * @author Seven Du */ public function show(ResponseFactory $response) @@ -91,9 +92,10 @@ public function show(ResponseFactory $response) /** * 解决数据结构和别名. * - * @param Collection &$options - * @param CommonConfig $item + * @param Collection &$options + * @param CommonConfig $item * @return vodi + * * @author Seven Du */ protected function resolve(Collection &$options, CommonConfig $item) @@ -109,9 +111,10 @@ protected function resolve(Collection &$options, CommonConfig $item) /** * 格式化数据. * - * @param string $type - * @param mixed $value + * @param string $type + * @param mixed $value * @return mixed + * * @author Seven Du */ protected function formatData(string $type, $value) diff --git a/app/Http/Controllers/APIs/V2/WalletRechargeAlipayController.php b/app/Http/Controllers/APIs/V2/WalletRechargeAlipayController.php index 8b644db73..1d01e46f1 100644 --- a/app/Http/Controllers/APIs/V2/WalletRechargeAlipayController.php +++ b/app/Http/Controllers/APIs/V2/WalletRechargeAlipayController.php @@ -36,8 +36,9 @@ class WalletRechargeAlipayController extends WalletRechargeController /** * Create a Alipay recharge charge. * - * @param \Zhiyi\Plus\Http\Requests\API2\StoreWalletRecharge $request + * @param \Zhiyi\Plus\Http\Requests\API2\StoreWalletRecharge $request * @return mixed + * * @author Seven Du */ public function create(StoreWalletRecharge $request) @@ -55,8 +56,9 @@ public function create(StoreWalletRecharge $request) /** * Create a APP rechrage by Alipay. * - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function alipayStore(ContractResponse $response) @@ -75,9 +77,10 @@ public function alipayStore(ContractResponse $response) /** * Create a wap recharge by Alipay. * - * @param \Zhiyi\Plus\Http\Requests\API2\StoreWalletRecharge $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Http\Requests\API2\StoreWalletRecharge $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function alipayWapStore(StoreWalletRecharge $request, ContractResponse $response) @@ -104,9 +107,10 @@ public function alipayWapStore(StoreWalletRecharge $request, ContractResponse $r /** * Create a PC recharge by Alipay. * - * @param \Zhiyi\Plus\Http\Requests\API2\StoreWalletRecharge $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Http\Requests\API2\StoreWalletRecharge $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author bs <414606094@qq.com> */ public function alipayPcDirectStore(StoreWalletRecharge $request, ContractResponse $response) diff --git a/app/Http/Controllers/APIs/V2/WalletRechargeApplePayController.php b/app/Http/Controllers/APIs/V2/WalletRechargeApplePayController.php index 405a6c966..8dce72f22 100644 --- a/app/Http/Controllers/APIs/V2/WalletRechargeApplePayController.php +++ b/app/Http/Controllers/APIs/V2/WalletRechargeApplePayController.php @@ -31,8 +31,8 @@ class WalletRechargeApplePayController extends WalletRechargeController * * @param \Zhiyi\Plus\Http\Requests\API2\StoreWalletRecharge; $request * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * * @return mixed + * * @author Seven Du */ public function create( diff --git a/app/Http/Controllers/APIs/V2/WalletRechargeController.php b/app/Http/Controllers/APIs/V2/WalletRechargeController.php index fe3d21ecb..57cc95118 100644 --- a/app/Http/Controllers/APIs/V2/WalletRechargeController.php +++ b/app/Http/Controllers/APIs/V2/WalletRechargeController.php @@ -61,8 +61,8 @@ public function __construct( * Create a recharge charge. * * @param \Zhiyi\Plus\Http\Requests\API2\StoreWalletRecharge $request - * * @return mixed + * * @author Seven Du */ public function store(StoreWalletRecharge $request) @@ -97,8 +97,8 @@ function () use ($request) { * Resolve store method. * * @param string $type - * * @return mixed + * * @author Seven Du */ protected function resolveStore(string $type) @@ -111,8 +111,8 @@ protected function resolveStore(string $type) * * @param \Zhiyi\Plus\Models\WalletCharge $charge * @param array $extra - * * @return array + * * @author Seven Du */ protected function createCharge( @@ -127,8 +127,8 @@ protected function createCharge( * * @param \Illuminate\Http\Request $request * @param string $channel - * * @return \Zhiyi\Plus\Models\WalletCharge + * * @author Seven Du */ protected function createChargeModel(Request $request, string $channel): WalletChargeModel diff --git a/app/Http/Controllers/Admin/AdvertisingController.php b/app/Http/Controllers/Admin/AdvertisingController.php index eca482bf6..e07e64ba8 100644 --- a/app/Http/Controllers/Admin/AdvertisingController.php +++ b/app/Http/Controllers/Admin/AdvertisingController.php @@ -31,7 +31,7 @@ class AdvertisingController extends Controller /** * 获取广告. * - * @param Request $request + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function ads(Request $request) @@ -63,7 +63,7 @@ public function ads(Request $request) /** * 根据ID获取广告. * - * @param Advertising $ad + * @param Advertising $ad * @return \Illuminate\Http\JsonResponse */ public function showAd(Advertising $ad) @@ -74,7 +74,7 @@ public function showAd(Advertising $ad) /** * 创建广告. * - * @param Request $request + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function storeAd(Request $request) @@ -114,8 +114,8 @@ public function storeAd(Request $request) /** * 更新广告. * - * @param Request $request - * @param Advertising $ad + * @param Request $request + * @param Advertising $ad * @return \Illuminate\Http\JsonResponse */ public function updateAd(Request $request, Advertising $ad) @@ -173,9 +173,10 @@ private function basisMsg() /** * 验证广告详细数据. * - * @param AdvertisingSpace $space - * @param Request $request + * @param AdvertisingSpace $space + * @param Request $request * @return mixed + * * @author BS <414606094@qq.com> */ protected function checkData(AdvertisingSpace $space, Request $request) @@ -243,7 +244,7 @@ public function spaces() /** * 删除广告. * - * @param Advertising $ad + * @param Advertising $ad * @return \Illuminate\Http\JsonResponse */ public function deleteAd(Advertising $ad) diff --git a/app/Http/Controllers/Admin/AuxiliaryController.php b/app/Http/Controllers/Admin/AuxiliaryController.php index 9bd6c89b8..8e94d75d6 100644 --- a/app/Http/Controllers/Admin/AuxiliaryController.php +++ b/app/Http/Controllers/Admin/AuxiliaryController.php @@ -29,6 +29,7 @@ class AuxiliaryController extends Controller * 清除缓存. * * @return mixed + * * @author BS <414606094@qq.com> */ public function cleanCache() diff --git a/app/Http/Controllers/Admin/CdnController.php b/app/Http/Controllers/Admin/CdnController.php index e2a849b8f..7c622abc5 100644 --- a/app/Http/Controllers/Admin/CdnController.php +++ b/app/Http/Controllers/Admin/CdnController.php @@ -30,6 +30,7 @@ class CdnController extends Controller * Get selected cdn. * * @return mixed + * * @author Seven Du */ public function getCdnSelected() @@ -41,6 +42,7 @@ public function getCdnSelected() * Get qiniu setting. * * @return mixed + * * @author Seven Du */ public function qiniu() @@ -59,8 +61,9 @@ public function qiniu() /** * Qiniu setting. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Plus\Support\Configuration $repository + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Plus\Support\Configuration $repository + * * @author Seven Du */ public function setQiniu(Request $request, ConfigurationRepository $repository) @@ -84,6 +87,7 @@ public function setQiniu(Request $request, ConfigurationRepository $repository) * Get local disk. * * @return mixed + * * @author Seven Du */ public function getFilesystemDisk() @@ -94,7 +98,8 @@ public function getFilesystemDisk() /** * 设置本地文件系统公开磁盘. * - * @param \Zhiyi\Plus\Support\Configuration $repository + * @param \Zhiyi\Plus\Support\Configuration $repository + * * @author Seven Du */ public function setPublicDisk(ConfigurationRepository $repository) @@ -111,6 +116,7 @@ public function setPublicDisk(ConfigurationRepository $repository) * 获取 local 磁盘公开地址. * * @return mixed + * * @author Seven Du */ public function getLocalDisk() @@ -121,8 +127,9 @@ public function getLocalDisk() /** * 设置 local 磁盘配置. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Plus\Support\Configuration $repository + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Plus\Support\Configuration $repository + * * @author Seven Du */ public function setLocalDisk(Request $request, ConfigurationRepository $repository) @@ -140,6 +147,7 @@ public function setLocalDisk(Request $request, ConfigurationRepository $reposito * 获取 S3 Disk 配置. * * @return mixed + * * @author Seven Du */ public function getS3Disk() @@ -150,8 +158,9 @@ public function getS3Disk() /** * 设置 S3 配置. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Plus\Support\Configuration $repository + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Plus\Support\Configuration $repository + * * @author Seven Du */ public function setS3Disk(Request $request, ConfigurationRepository $repository) @@ -172,6 +181,7 @@ public function setS3Disk(Request $request, ConfigurationRepository $repository) * Get alioss setting. * * @return mixed + * * @author BS <414606094@qq.com> */ public function alioss() @@ -191,8 +201,9 @@ public function alioss() /** * alioss setting. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Plus\Support\Configuration $repository + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Plus\Support\Configuration $repository + * * @author BS <414606094@qq.com> */ public function setAlioss(Request $request, ConfigurationRepository $repository) diff --git a/app/Http/Controllers/Admin/CertificationCategoryController.php b/app/Http/Controllers/Admin/CertificationCategoryController.php index 04443a29a..a18d93cd2 100644 --- a/app/Http/Controllers/Admin/CertificationCategoryController.php +++ b/app/Http/Controllers/Admin/CertificationCategoryController.php @@ -28,7 +28,8 @@ class CertificationCategoryController extends Controller { /** * certification categories list. - * @param Request $request + * + * @param Request $request * @author: huhao <915664508@qq.com> */ public function certifications() @@ -54,7 +55,8 @@ public function show(CertificationCategory $category) /** * update certification category. - * @param Request $request + * + * @param Request $request * @param $name * @return $this * @author: huhao <915664508@qq.com> diff --git a/app/Http/Controllers/Admin/CertificationController.php b/app/Http/Controllers/Admin/CertificationController.php index 4a236cb72..2fd65bf6c 100644 --- a/app/Http/Controllers/Admin/CertificationController.php +++ b/app/Http/Controllers/Admin/CertificationController.php @@ -35,7 +35,7 @@ class CertificationController extends Controller /** * certification list. * - * @param Request $request + * @param Request $request * @return $this */ public function index(Request $request) @@ -92,7 +92,7 @@ protected function certificationCount() /** * certifiction pass. * - * @param certification $certification + * @param certification $certification * @return \Illuminate\Http\JsonResponse */ public function passCertification(Request $request, Certification $certification) @@ -124,8 +124,8 @@ public function passCertification(Request $request, Certification $certification /** * certifiction reject. * - * @param Request $request - * @param Certification $certification + * @param Request $request + * @param Certification $certification * @return \Illuminate\Http\JsonResponse */ public function rejectCertification(Request $request, Certification $certification) @@ -158,7 +158,7 @@ public function rejectCertification(Request $request, Certification $certificati /** * get certification detail. * - * @param Certification $certification + * @param Certification $certification * @return $this */ public function show(Certification $certification) @@ -169,9 +169,9 @@ public function show(Certification $certification) /** * update user certification. * - * @param UserCertification $request - * @param Certification $certification - * @param FileWithModel $fileWithModel + * @param UserCertification $request + * @param Certification $certification + * @param FileWithModel $fileWithModel * @return mixed */ public function update( @@ -288,9 +288,9 @@ public function messages() /** * add user certification. * - * @param UserCertification $request - * @param Certification $certification - * @param FileWithModel $fileWithModel + * @param UserCertification $request + * @param Certification $certification + * @param FileWithModel $fileWithModel * @return \Illuminate\Http\JsonResponse|mixed */ public function store(Request $request, @@ -342,7 +342,7 @@ public function store(Request $request, /** * Search for non certification users. * - * @param Request $request + * @param Request $request * @return $this|\Illuminate\Http\JsonResponse */ public function findNoCertificationUsers(Request $request) @@ -359,9 +359,10 @@ public function findNoCertificationUsers(Request $request) /** * File not with file models. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Plus\Models\FileWith $fileWithModel + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Plus\Models\FileWith $fileWithModel * @return \Illuminate\Support\Collection + * * @author Seven Du */ protected function findNotWithFileModels(Request $request, FileWithModel $fileWithModel): Collection diff --git a/app/Http/Controllers/Admin/CorsController.php b/app/Http/Controllers/Admin/CorsController.php index 625b1e30d..1b9834385 100644 --- a/app/Http/Controllers/Admin/CorsController.php +++ b/app/Http/Controllers/Admin/CorsController.php @@ -31,6 +31,7 @@ class CorsController * Fetch CORS settings. * * @return \Illuminate\Http\JsonResponse + * * @author Seven Du */ public function fetch(): JsonResponse diff --git a/app/Http/Controllers/Admin/CurrencyAppleController.php b/app/Http/Controllers/Admin/CurrencyAppleController.php index c954ed70d..7725fa5e6 100644 --- a/app/Http/Controllers/Admin/CurrencyAppleController.php +++ b/app/Http/Controllers/Admin/CurrencyAppleController.php @@ -31,6 +31,7 @@ class CurrencyAppleController extends Controller * 获取苹果IAP设置. * * @return mixed + * * @author BS <414606094@qq.com> */ public function getConfig() @@ -44,8 +45,9 @@ public function getConfig() /** * 保存IAP配置. * - * @param Request $request - * @param Repository $config + * @param Request $request + * @param Repository $config + * * @author BS <414606094@qq.com> */ public function setConfig(Request $request, Configuration $configuration) @@ -63,8 +65,9 @@ public function setConfig(Request $request, Configuration $configuration) /** * 获取苹果商品列表. * - * @param CommonConfig $configModel + * @param CommonConfig $configModel * @return mixed + * * @author BS <414606094@qq.com> */ public function getProducts(CommonConfig $configModel) @@ -77,7 +80,8 @@ public function getProducts(CommonConfig $configModel) /** * 添加商品. * - * @param Request $request + * @param Request $request + * * @author BS <414606094@qq.com> */ public function addProduct(Request $request, CommonConfig $configModel) @@ -106,9 +110,10 @@ public function addProduct(Request $request, CommonConfig $configModel) /** * 删除商品. * - * @param Request $request - * @param CommonConfig $configModel + * @param Request $request + * @param CommonConfig $configModel * @return mixed + * * @author BS <414606094@qq.com> */ public function delProduct(Request $request, CommonConfig $configModel) diff --git a/app/Http/Controllers/Admin/CurrencyCashController.php b/app/Http/Controllers/Admin/CurrencyCashController.php index a43739c69..8c58e63c7 100644 --- a/app/Http/Controllers/Admin/CurrencyCashController.php +++ b/app/Http/Controllers/Admin/CurrencyCashController.php @@ -34,9 +34,10 @@ class CurrencyCashController extends Controller /** * 提现列表. * - * @param Request $request - * @param OrderModel $orderModel + * @param Request $request + * @param OrderModel $orderModel * @return mixed + * * @author BS <414606094@qq.com> */ public function list(Request $request, OrderModel $orderModel) @@ -73,8 +74,8 @@ public function list(Request $request, OrderModel $orderModel) /** * 审核积分提现. * - * @param Request $request - * @param OrderModel $order + * @param Request $request + * @param OrderModel $order * @return mixed */ public function audit(Request $request, OrderModel $order) diff --git a/app/Http/Controllers/Admin/CurrencyController.php b/app/Http/Controllers/Admin/CurrencyController.php index 1d1d5bfb6..e89e4c7e2 100644 --- a/app/Http/Controllers/Admin/CurrencyController.php +++ b/app/Http/Controllers/Admin/CurrencyController.php @@ -69,7 +69,7 @@ public function showConfig() /** * 更新积分基础配置. * - * @param Request $request + * @param Request $request * @return mixed */ public function updateConfig(Request $request) @@ -106,9 +106,10 @@ public function updateConfig(Request $request) /** * 积分流水. * - * @param Request $request - * @param OrderModel $orderModel + * @param Request $request + * @param OrderModel $orderModel * @return mixed + * * @author BS <414606094@qq.com> */ public function list(Request $request, OrderModel $orderModel) @@ -148,8 +149,9 @@ public function list(Request $request, OrderModel $orderModel) /** * 积分概览. * - * @param Request $request + * @param Request $request * @return mixed + * * @author BS <414606094@qq.com> */ public function overview(OrderModel $orderModel) @@ -166,7 +168,7 @@ public function overview(OrderModel $orderModel) /** * 获取用户积分信息. * - * @param Request $request + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function index(Request $request) @@ -206,8 +208,8 @@ public function index(Request $request) /** * 用户积分赋值. * - * @param Request $request - * @param Common $common + * @param Request $request + * @param Common $common * @return \Illuminate\Http\JsonResponse */ public function add(Request $request, Common $common) diff --git a/app/Http/Controllers/Admin/FileController.php b/app/Http/Controllers/Admin/FileController.php index ed040ae1c..c08f2f3c4 100644 --- a/app/Http/Controllers/Admin/FileController.php +++ b/app/Http/Controllers/Admin/FileController.php @@ -30,8 +30,9 @@ class FileController extends Controller /** * 获取附件基本配置. * - * @param Repository $config + * @param Repository $config * @return mixed + * * @author BS <414606094@qq.com> */ public function getConfig(Repository $config) @@ -47,8 +48,9 @@ public function getConfig(Repository $config) /** * 保存附件基本配置. * - * @param Request $request - * @param Configuration $config + * @param Request $request + * @param Configuration $config + * * @author BS <414606094@qq.com> */ public function setConfig(Request $request, Configuration $config) diff --git a/app/Http/Controllers/Admin/GoldRuleController.php b/app/Http/Controllers/Admin/GoldRuleController.php index 99d8a876d..dc9fa76cf 100644 --- a/app/Http/Controllers/Admin/GoldRuleController.php +++ b/app/Http/Controllers/Admin/GoldRuleController.php @@ -48,7 +48,7 @@ public function rules(Request $request) /** * show rule. * - * @param GoldRule $rule + * @param GoldRule $rule * @return \Illuminate\Http\JsonResponse */ public function showRule(GoldRule $rule) @@ -73,7 +73,7 @@ public function abilities() /** * store gold rule. * - * @param Request $request + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function storeRule(Request $request) @@ -94,8 +94,8 @@ public function storeRule(Request $request) /** * update gold rule. * - * @param Request $request - * @param GoldRule $goldRule + * @param Request $request + * @param GoldRule $goldRule * @return \Illuminate\Http\JsonResponse */ public function updateRule(Request $request, GoldRule $rule) @@ -115,7 +115,8 @@ public function updateRule(Request $request, GoldRule $rule) /** * delete rule. - * @param GoldRule $rule + * + * @param GoldRule $rule * @return \Illuminate\Http\JsonResponse */ public function deleteRule(GoldRule $rule) diff --git a/app/Http/Controllers/Admin/HomeController.php b/app/Http/Controllers/Admin/HomeController.php index ec13f18ea..65d2fae93 100644 --- a/app/Http/Controllers/Admin/HomeController.php +++ b/app/Http/Controllers/Admin/HomeController.php @@ -30,8 +30,9 @@ class HomeController extends Controller /** * Admin home. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return mixed + * * @author Seven Du */ public function index(Request $request) @@ -53,6 +54,7 @@ public function index(Request $request) * 后台导航菜单. * * @return mixed + * * @author Seven Du */ public function showManages(ManageRepository $repository) diff --git a/app/Http/Controllers/Admin/NewWalletController.php b/app/Http/Controllers/Admin/NewWalletController.php index de8c11034..08bf8e14c 100644 --- a/app/Http/Controllers/Admin/NewWalletController.php +++ b/app/Http/Controllers/Admin/NewWalletController.php @@ -52,7 +52,6 @@ public function statistics() * 新版钱包流水. * * @param Request $request - * * @return \Illuminate\Http\JsonResponse */ public function waters(Request $request) diff --git a/app/Http/Controllers/Admin/ReportController.php b/app/Http/Controllers/Admin/ReportController.php index 861f4f8c3..b283fc286 100644 --- a/app/Http/Controllers/Admin/ReportController.php +++ b/app/Http/Controllers/Admin/ReportController.php @@ -30,7 +30,7 @@ class ReportController extends Controller /** * 举报列表. * - * @param Request $request + * @param Request $request * @return mixed */ public function index(Request $request) @@ -59,8 +59,8 @@ public function index(Request $request) /** * 处理举报. * - * @param Request $request - * @param ReportModel $report + * @param Request $request + * @param ReportModel $report * @return mixed */ public function deal(Request $request, ReportModel $report) @@ -88,9 +88,10 @@ public function deal(Request $request, ReportModel $report) /** * 驳回举报. * - * @param Request $request - * @param ReportModel $report + * @param Request $request + * @param ReportModel $report * @return mixed + * * @author BS <414606094@qq.com> */ public function reject(Request $request, ReportModel $report) @@ -119,6 +120,7 @@ public function reject(Request $request, ReportModel $report) * 判断是否安装了pc扩展. * * @return bool + * * @author BS <414606094@qq.com> */ protected function getPcInstalled(): bool diff --git a/app/Http/Controllers/Admin/RewardController.php b/app/Http/Controllers/Admin/RewardController.php index 897ee460a..4657d6209 100644 --- a/app/Http/Controllers/Admin/RewardController.php +++ b/app/Http/Controllers/Admin/RewardController.php @@ -36,7 +36,7 @@ class RewardController extends Controller /** * 打赏日期分组统计. * - * @param Request $request + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function statistics(Request $request) @@ -49,7 +49,7 @@ public function statistics(Request $request) /** * 根据条件获取统计数据. * - * @param Request $request + * @param Request $request * @return mixed */ protected function byConditionsGetStatisticsData(Request $request) @@ -96,7 +96,7 @@ protected function byConditionsGetStatisticsData(Request $request) /** * 打赏清单. * - * @param Request $request + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function rewards(Request $request) @@ -141,7 +141,7 @@ public function rewards(Request $request) /** * 导出下载. * - * @param Request $request + * @param Request $request */ public function export(Request $request) { @@ -160,7 +160,7 @@ public function export(Request $request) /** * 根据条件获取打赏数据. * - * @param Request $request + * @param Request $request * @return mixed */ protected function byConditionsGetRewardData(Request $request) @@ -199,7 +199,7 @@ protected function byConditionsGetRewardData(Request $request) /** * 转换打赏数组. * - * @param array $data + * @param array $data * @return array */ public function convertRewardData(array $data) @@ -235,9 +235,9 @@ protected function getRewardavelTypes() /** * export excel. * - * @param array $data 数据 - * @param array $title 列名 - * @param string $filename + * @param array $data 数据 + * @param array $title 列名 + * @param string $filename */ public function exportExcel(array $data = [], array $title = [], $filename = 'export') { diff --git a/app/Http/Controllers/Admin/RoleController.php b/app/Http/Controllers/Admin/RoleController.php index f880e87ca..0ee3ecdbd 100644 --- a/app/Http/Controllers/Admin/RoleController.php +++ b/app/Http/Controllers/Admin/RoleController.php @@ -50,8 +50,7 @@ public function roles(Request $request) /** * 删除用户组. * - * @param Role $role - * + * @param Role $role * @return mixed * * @author Seven Du @@ -76,8 +75,9 @@ public function delete(Request $request, Role $role) /** * 创建角色接口. * - * @param Request $request + * @param Request $request * @return mixed + * * @author Seven Du */ public function createRole(Request $request) @@ -119,9 +119,10 @@ public function createRole(Request $request) /** * 完成获取角色接口. * - * @param Request $request - * @param Role $role + * @param Request $request + * @param Role $role * @return mixed + * * @author Seven Du */ public function showRole(Request $request, Role $role) @@ -153,9 +154,10 @@ public function showRole(Request $request, Role $role) /** * 更新角色信息. * - * @param Request $request - * @param Role $role + * @param Request $request + * @param Role $role * @return mixed + * * @author Seven Du */ public function updateRole(Request $request, Role $role) @@ -197,8 +199,9 @@ public function abilities(Request $request) /** * 创建权限节点. * - * @param Request $request + * @param Request $request * @return mixed + * * @author Seven Du */ public function createAbility(Request $request) @@ -240,9 +243,8 @@ public function createAbility(Request $request) /** * 更新权限节点. * - * @param Request $request - * @param Ability $ability - * + * @param Request $request + * @param Ability $ability * @return mixed * * @author Seven Du @@ -280,8 +282,9 @@ public function updateAbility(Request $request, Ability $ability) /** * 删除权限节点. * - * @param Ability $ability + * @param Ability $ability * @return mixed + * * @author Seven Du */ public function deleteAbility(Request $request, Ability $ability) diff --git a/app/Http/Controllers/Admin/SensitiveController.php b/app/Http/Controllers/Admin/SensitiveController.php index 3534b2d55..ff1fda9e8 100644 --- a/app/Http/Controllers/Admin/SensitiveController.php +++ b/app/Http/Controllers/Admin/SensitiveController.php @@ -31,8 +31,9 @@ class SensitiveController extends Controller /** * List all sensitives. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return mixed + * * @author Seven Du */ public function index(Request $request) @@ -63,8 +64,9 @@ public function index(Request $request) /** * Create a sensitive. * - * @param \Zhiyi\Plus\Http\Requests\Admin\CreateSensitive $request + * @param \Zhiyi\Plus\Http\Requests\Admin\CreateSensitive $request * @return mixed + * * @author Seven Du */ public function store(CreateSensitiveRequest $request) @@ -85,9 +87,10 @@ public function store(CreateSensitiveRequest $request) /** * Uodate a sensitive. * - * @param \Zhiyi\Plus\Http\Requests\Admin\UpdateSensitive $request - * @param \Zhiyi\Plus\Models\Sensitive $sensitive + * @param \Zhiyi\Plus\Http\Requests\Admin\UpdateSensitive $request + * @param \Zhiyi\Plus\Models\Sensitive $sensitive * @return mixed + * * @author Seven Du */ public function update(UpdateSensitiveRequest $request, SensitiveModel $sensitive) @@ -111,8 +114,9 @@ public function update(UpdateSensitiveRequest $request, SensitiveModel $sensitiv /** * Destroy a sensitive. * - * @param \Zhiyi\Plus\Models\Sensitive $sensitive + * @param \Zhiyi\Plus\Models\Sensitive $sensitive * @return mixed + * * @author Seven Du */ public function destroy(SensitiveModel $sensitive) diff --git a/app/Http/Controllers/Admin/SiteController.php b/app/Http/Controllers/Admin/SiteController.php index f7f2122b5..f658d3f4c 100644 --- a/app/Http/Controllers/Admin/SiteController.php +++ b/app/Http/Controllers/Admin/SiteController.php @@ -47,7 +47,8 @@ class SiteController extends Controller /** * Construct handle. * - * @param \Illuminate\Contracts\Foundation\Application $app + * @param \Illuminate\Contracts\Foundation\Application $app + * * @author Seven Du */ public function __construct(Application $app, CommonConfig $config) @@ -88,8 +89,7 @@ public function get(Request $request, Repository $config, ResponseFactory $respo /** * 更新网站基本信息. * - * @param Request $request - * + * @param Request $request * @return mixed * * @author Seven Du @@ -144,8 +144,7 @@ public function areas(Request $request) /** * 添加地区. * - * @param Request $request - * + * @param Request $request * @return mixed [description] * * @author Seven Du @@ -191,8 +190,7 @@ public function doAddArea(Request $request) /** * 删除地区. * - * @param int $id - * + * @param int $id * @return mixed * * @author Seven Du @@ -222,9 +220,8 @@ public function deleteArea(Request $request, int $id) /** * 更新地区数据. * - * @param Request $request - * @param Area $area - * + * @param Request $request + * @param Area $area * @return mixed * * @author Seven Du @@ -344,7 +341,7 @@ protected function hotAreaExists(array $hotAreas, $hotAreaName) /** * 删除热门城市. * - * @param array &$hotAreas [description] + * @param array &$hotAreas [description] * @param [type] $hotAreaName [description] * @return [type] [description] */ @@ -478,7 +475,7 @@ public function siteConfigurations() /** * 更新站点设置. * - * @param Request $request + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function updateSiteConfigure(Request $request) @@ -507,8 +504,9 @@ public function updateSiteConfigure(Request $request) /** * 获取后台页面配置. * - * @param Configuration $config [description] + * @param Configuration $config [description] * @return [type] [description] + * * @author BS <414606094@qq.com> */ public function getBackGroundConfiguration(Repository $config) diff --git a/app/Http/Controllers/Admin/SmsController.php b/app/Http/Controllers/Admin/SmsController.php index e088e59ac..ca6e963ae 100644 --- a/app/Http/Controllers/Admin/SmsController.php +++ b/app/Http/Controllers/Admin/SmsController.php @@ -32,9 +32,10 @@ class SmsController extends Controller /** * Show SMS logs. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function show(Request $request, ResponseFactory $response, VerificationCode $model) @@ -64,7 +65,7 @@ public function show(Request $request, ResponseFactory $response, VerificationCo /** * 获取短信所有配置网关. * - * @param Repository $config + * @param Repository $config * @return ResponseFactory|\Symfony\Component\HttpFoundation\Response */ public function showGateway(Repository $config) @@ -80,9 +81,9 @@ public function showGateway(Repository $config) /** * 更新允许的网关. * - * @param Request $request - * @param Repository $config - * @param Configuration $store + * @param Request $request + * @param Repository $config + * @param Configuration $store * @return ResponseFactory|\Symfony\Component\HttpFoundation\Response */ public function updateGateway(Request $request, Repository $config, Configuration $store) @@ -108,10 +109,11 @@ public function updateGateway(Request $request, Repository $config, Configuratio /** * Get SMS driver configuration information. * - * @param \Illuminate\Contracts\Config\Repository $config - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param string $driver + * @param \Illuminate\Contracts\Config\Repository $config + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param string $driver * @return mixed + * * @author Seven Du */ public function showOption(Repository $config, ResponseFactory $response, string $driver) @@ -128,12 +130,13 @@ public function showOption(Repository $config, ResponseFactory $response, string /** * Update Ali SMS configuration information. * - * @param Repository $config - * @param Configuration $store - * @param Request $request - * @param ResponseFactory $response - * @param string $driver + * @param Repository $config + * @param Configuration $store + * @param Request $request + * @param ResponseFactory $response + * @param string $driver * @return mixed + * * @author Seven Du */ public function updateAlidayuOption(Configuration $store, Request $request, ResponseFactory $response) @@ -153,12 +156,13 @@ public function updateAlidayuOption(Configuration $store, Request $request, Resp /** * Update Aliyun SMS configuration information. * - * @param Repository $config - * @param Configuration $store - * @param Request $request - * @param ResponseFactory $response - * @param string $driver + * @param Repository $config + * @param Configuration $store + * @param Request $request + * @param ResponseFactory $response + * @param string $driver * @return mixed + * * @author Seven Du */ public function updateAliyunOption(Configuration $store, Request $request) @@ -178,12 +182,13 @@ public function updateAliyunOption(Configuration $store, Request $request) /** * Update Yunpian SMS configuration information. * - * @param Repository $config - * @param Configuration $store - * @param Request $request - * @param ResponseFactory $response - * @param string $driver + * @param Repository $config + * @param Configuration $store + * @param Request $request + * @param ResponseFactory $response + * @param string $driver * @return mixed + * * @author Seven Du */ public function updateYunpianOption(Configuration $store, Request $request) @@ -217,7 +222,7 @@ public function updateHuyiOption(Configuration $store, Request $request) /** * Get SMS driver Template configuration information. * - * @param Repository $config [description] + * @param Repository $config [description] * @return [type] [description] */ public function smsTemplate(Repository $config) @@ -235,9 +240,9 @@ public function smsTemplate(Repository $config) /** * Update SMS driver Template configuration information. * - * @param Repository $config - * @param Configuration $store - * @param Request $request + * @param Repository $config + * @param Configuration $store + * @param Request $request * @return [type] */ public function updateTemplate(Configuration $store, Request $request) diff --git a/app/Http/Controllers/Admin/SystemController.php b/app/Http/Controllers/Admin/SystemController.php index 2cee4ca5b..535ebaeea 100644 --- a/app/Http/Controllers/Admin/SystemController.php +++ b/app/Http/Controllers/Admin/SystemController.php @@ -33,6 +33,7 @@ class SystemController extends Controller * * @param Request $request * @return \Illuminate\Http\JsonResponse|object + * * @author bs<414606094@qq.com> */ public function pushSystemNotice(Request $request) diff --git a/app/Http/Controllers/Admin/UserController.php b/app/Http/Controllers/Admin/UserController.php index d1ef71fc4..42228ce31 100644 --- a/app/Http/Controllers/Admin/UserController.php +++ b/app/Http/Controllers/Admin/UserController.php @@ -37,8 +37,9 @@ class UserController extends Controller /** * 获取用户列表数据. * - * @param Request $request + * @param Request $request * @return mixed + * * @author Seven Du */ public function users(Request $request) @@ -154,7 +155,8 @@ public function users(Request $request) /** * 设置注册时关注. - * @param Request $request [description] + * + * @param Request $request [description] * @return [type] [description] */ public function handleFamous(Request $request, Famous $famous) @@ -180,7 +182,8 @@ public function handleFamous(Request $request, Famous $famous) /** * 取消注册时关注. - * @param Request $request [description] + * + * @param Request $request [description] * @return [type] [description] */ public function handleUnFamous(User $user, Famous $famous) @@ -272,8 +275,8 @@ public function recommends(Request $request) } /** - * @param Request $request - * @param User $user + * @param Request $request + * @param User $user * @return mixed */ public function update(Request $request, User $user) @@ -348,7 +351,7 @@ public function update(Request $request, User $user) } /** - * @param Request $request + * @param Request $request * @return mixed */ public function store(Request $request) @@ -398,8 +401,9 @@ public function store(Request $request) /** * 删除用户. * - * @param User $user + * @param User $user * @return mixed + * * @author Seven Du */ public function deleteUser(Request $request, User $user) @@ -418,8 +422,9 @@ public function deleteUser(Request $request, User $user) /** * 获取用户资料. * - * @param User $user + * @param User $user * @return mixed + * * @author Seven Du */ public function showUser(Request $request, User $user) @@ -447,6 +452,7 @@ public function showUser(Request $request, User $user) * 获取用户信息设置. * * @return mixed + * * @author Seven Du */ public function showSetting() @@ -462,8 +468,9 @@ public function showSetting() /** * 储存用户基本设置. * - * @param Request $request + * @param Request $request * @return mixed + * * @author Seven Du */ public function storeSetting(Request $request) @@ -489,7 +496,8 @@ public function storeSetting(Request $request) /** * 增加推荐用户. - * @param Request $request [description] + * + * @param Request $request [description] * @return [type] [description] */ public function handleRecommend(Request $request, UserRecommended $recommend) @@ -508,8 +516,9 @@ public function handleRecommend(Request $request, UserRecommended $recommend) /** * 取消用户推荐. - * @param Request $request [description] - * @param User $user [description] + * + * @param Request $request [description] + * @param User $user [description] * @return [type] [description] */ public function handleUnRecommend(User $user, UserRecommended $recommend) @@ -526,7 +535,8 @@ public function handleUnRecommend(User $user, UserRecommended $recommend) /** * 注册配置，暂时存放于配置文件. - * @param Request $request [description] + * + * @param Request $request [description] * @return [type] [description] */ public function updateRegisterSetting(Request $request) @@ -544,6 +554,7 @@ public function updateRegisterSetting(Request $request) /** * 获取注册配置. + * * @return [type] [description] */ public function getRegisterSetting() diff --git a/app/Http/Controllers/Admin/WalletCashController.php b/app/Http/Controllers/Admin/WalletCashController.php index fe3d11eb7..f7e5960f1 100644 --- a/app/Http/Controllers/Admin/WalletCashController.php +++ b/app/Http/Controllers/Admin/WalletCashController.php @@ -33,8 +33,9 @@ class WalletCashController extends Controller /** * 获取提现列表. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return mixed + * * @author Seven Du */ public function show(Request $request) @@ -78,9 +79,10 @@ public function show(Request $request) /** * 通过审批. * - * @param Request $request - * @param WalletCash $cash + * @param Request $request + * @param WalletCash $cash * @return mixed + * * @author Seven Du */ public function passed(Request $request, WalletCash $cash) @@ -126,9 +128,10 @@ public function passed(Request $request, WalletCash $cash) /** * 提现驳回. * - * @param Request $request - * @param WalletCash $cash + * @param Request $request + * @param WalletCash $cash * @return mixed + * * @author Seven Du */ public function refuse(Request $request, WalletCash $cash) diff --git a/app/Http/Controllers/Admin/WalletCashSettingController.php b/app/Http/Controllers/Admin/WalletCashSettingController.php index e331a20a4..c933e3d4e 100644 --- a/app/Http/Controllers/Admin/WalletCashSettingController.php +++ b/app/Http/Controllers/Admin/WalletCashSettingController.php @@ -30,6 +30,7 @@ class WalletCashSettingController extends Controller * 获取提现设置. * * @return mixed + * * @author Seven Du */ public function show() @@ -43,8 +44,9 @@ public function show() /** * 更新提现设置. * - * @param Request $request + * @param Request $request * @return mexed + * * @author Seven Du */ public function update(Request $request) diff --git a/app/Http/Controllers/Admin/WalletChargeController.php b/app/Http/Controllers/Admin/WalletChargeController.php index e5740a40b..36736dc97 100644 --- a/app/Http/Controllers/Admin/WalletChargeController.php +++ b/app/Http/Controllers/Admin/WalletChargeController.php @@ -31,9 +31,10 @@ class WalletChargeController extends Controller /** * 获取凭据列表. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function show(Request $request, ContractResponse $response) @@ -65,8 +66,9 @@ public function show(Request $request, ContractResponse $response) /** * Setting wheres. * - * @param \Illuminate\Database\Eloquent\Builder &$query - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Database\Eloquent\Builder &$query + * @param \Illuminate\Http\Request $request + * * @author Seven Du */ protected function setWhere(Builder &$query, Request $request) @@ -83,8 +85,9 @@ protected function setWhere(Builder &$query, Request $request) /** * Setting account. * - * @param \Illuminate\Database\Eloquent\Builder &$query - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Database\Eloquent\Builder &$query + * @param \Illuminate\Http\Request $request + * * @author Seven Du */ protected function setAccountToBuilder(Builder &$query, Request $request) @@ -101,8 +104,9 @@ protected function setAccountToBuilder(Builder &$query, Request $request) /** * Setting user id to builder where. * - * @param \Illuminate\Database\Eloquent\Builder &$query - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Database\Eloquent\Builder &$query + * @param \Illuminate\Http\Request $request + * * @author Seven Du */ protected function setUserToBuilder(Builder &$query, Request $request) @@ -119,8 +123,8 @@ protected function setUserToBuilder(Builder &$query, Request $request) /** * Setting user name to builder where. * - * @param Builder &$query - * @param Request $request + * @param Builder &$query + * @param Request $request */ protected function setUserNameTobuilder(Builder &$query, Request $request) { @@ -139,6 +143,7 @@ protected function setUserNameTobuilder(Builder &$query, Request $request) * Get Query. * * @return \Illuminate\Database\Eloquent\Builder + * * @author Seven Du */ protected function query(): Builder diff --git a/app/Http/Controllers/Admin/WalletLabelController.php b/app/Http/Controllers/Admin/WalletLabelController.php index 83c470ba6..22b74b3c1 100644 --- a/app/Http/Controllers/Admin/WalletLabelController.php +++ b/app/Http/Controllers/Admin/WalletLabelController.php @@ -31,6 +31,7 @@ class WalletLabelController extends Controller * Get wallet labels. * * @return mixed + * * @author Seven Du */ public function labels() @@ -43,8 +44,9 @@ public function labels() /** * Create a recharge option tab. * - * @param Request $request + * @param Request $request * @return mixed + * * @author Seven Du */ public function storeLabel(Request $request) @@ -79,8 +81,9 @@ public function storeLabel(Request $request) /** * Remove the recharge option. * - * @param int $label + * @param int $label * @return mixed + * * @author Seven Du */ public function deleteLabel(int $label) diff --git a/app/Http/Controllers/Admin/WalletPingPlusPlusController.php b/app/Http/Controllers/Admin/WalletPingPlusPlusController.php index ae0242d9d..ff57696e8 100644 --- a/app/Http/Controllers/Admin/WalletPingPlusPlusController.php +++ b/app/Http/Controllers/Admin/WalletPingPlusPlusController.php @@ -30,8 +30,9 @@ class WalletPingPlusPlusController extends Controller /** * Get the Ping++ config. * - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function show(ContractResponse $response) @@ -44,9 +45,10 @@ public function show(ContractResponse $response) /** * Update Ping++ config. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function update(Request $request, ContractResponse $response) @@ -64,6 +66,7 @@ public function update(Request $request, ContractResponse $response) * Get valodate rule. * * @return array + * * @author Seven Du */ protected function rules(): array @@ -80,6 +83,7 @@ protected function rules(): array * Get validate error messages. * * @return array + * * @author Seven Du */ protected function validateErrorMessages(): array diff --git a/app/Http/Controllers/Admin/WalletRatioController.php b/app/Http/Controllers/Admin/WalletRatioController.php index b8ca0e51e..7448bb18d 100644 --- a/app/Http/Controllers/Admin/WalletRatioController.php +++ b/app/Http/Controllers/Admin/WalletRatioController.php @@ -30,8 +30,9 @@ class WalletRatioController extends Controller /** * Get the recharge conversion value. * - * @param ResponseFactory $response + * @param ResponseFactory $response * @return mixed + * * @author Seven Du */ public function show(ResponseFactory $response) @@ -44,9 +45,10 @@ public function show(ResponseFactory $response) /** * 更新转换比例. * - * @param Request $request - * @param ResponseFactory $response + * @param Request $request + * @param ResponseFactory $response * @return mixed + * * @author Seven Du */ public function update(Request $request, ResponseFactory $response) diff --git a/app/Http/Controllers/Admin/WalletRechargeTypeController.php b/app/Http/Controllers/Admin/WalletRechargeTypeController.php index 8c8e7cdb0..1ae586a5d 100644 --- a/app/Http/Controllers/Admin/WalletRechargeTypeController.php +++ b/app/Http/Controllers/Admin/WalletRechargeTypeController.php @@ -30,8 +30,9 @@ class WalletRechargeTypeController extends Controller /** * Get support types. * - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function show(ContractResponse $response) @@ -47,9 +48,10 @@ public function show(ContractResponse $response) /** * Update support types. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed + * * @author Seven Du */ public function update(Request $request, ContractResponse $response) @@ -66,6 +68,7 @@ public function update(Request $request, ContractResponse $response) * Get support types. * * @return array + * * @author Seven Du */ protected function getSupportTypes(): array @@ -90,6 +93,7 @@ protected function getSupportTypes(): array * Get validate rules. * * @return array + * * @author Seven Du */ protected function rules(): array @@ -103,6 +107,7 @@ protected function rules(): array * Get validate error messages. * * @return array + * * @author Seven Du */ protected function validateErrorMessages(): array diff --git a/app/Http/Controllers/Admin/WalletRuleController.php b/app/Http/Controllers/Admin/WalletRuleController.php index 1df5c05dd..c3a096ed2 100644 --- a/app/Http/Controllers/Admin/WalletRuleController.php +++ b/app/Http/Controllers/Admin/WalletRuleController.php @@ -30,8 +30,9 @@ class WalletRuleController extends Controller /** * Get the recharge and withdraw the rules. * - * @param ResponseFactory $response + * @param ResponseFactory $response * @return mixed + * * @author Seven Du */ public function show(ResponseFactory $response) @@ -44,9 +45,10 @@ public function show(ResponseFactory $response) /** * 更新规则. * - * @param Request $request - * @param ResponseFactory $response + * @param Request $request + * @param ResponseFactory $response * @return mixed + * * @author Seven Du */ public function update(Request $request, ResponseFactory $response) diff --git a/app/Http/Controllers/Admin/WalletStatisticsController.php b/app/Http/Controllers/Admin/WalletStatisticsController.php index 9e01967ce..adc63c4bc 100644 --- a/app/Http/Controllers/Admin/WalletStatisticsController.php +++ b/app/Http/Controllers/Admin/WalletStatisticsController.php @@ -54,7 +54,7 @@ public function index(Request $request) /** * 充值统计. * - * @param array $scope + * @param array $scope * @return array */ private function chargeStatistics(array $scope) @@ -74,7 +74,7 @@ private function chargeStatistics(array $scope) /** * 提现统计. * - * @param array $scope + * @param array $scope * @return array */ private function casheStatistics(array $scope) diff --git a/app/Http/Controllers/Admin/WebClientsController.php b/app/Http/Controllers/Admin/WebClientsController.php index 652dc259c..5038b3835 100644 --- a/app/Http/Controllers/Admin/WebClientsController.php +++ b/app/Http/Controllers/Admin/WebClientsController.php @@ -31,6 +31,7 @@ class WebClientsController * Fetch web clients setting data. * * @return \Illuminate\Http\JsonResponse + * * @author Seven Du */ public function fetch(): JsonResponse @@ -50,9 +51,10 @@ public function fetch(): JsonResponse /** * Update web clients settings. * - * @param \Zhiyi\Plus\Http\Requests\Admin\UpdateWebClientRequest $request - * @param \Zhiyi\Plus\Support\Configuration $config + * @param \Zhiyi\Plus\Http\Requests\Admin\UpdateWebClientRequest $request + * @param \Zhiyi\Plus\Support\Configuration $config * @return \Illuminate\Http\Response + * * @author Seven Du */ public function update(UpdateWebClientRequest $request, Configuration $config): Response diff --git a/app/Http/Controllers/Auth/LoginController.php b/app/Http/Controllers/Auth/LoginController.php index 91ff84f5a..ff28d4525 100644 --- a/app/Http/Controllers/Auth/LoginController.php +++ b/app/Http/Controllers/Auth/LoginController.php @@ -48,6 +48,7 @@ public function __construct() * Show the application's login form. * * @return mixed + * * @author Seven Du */ public function showLoginForm(Repository $config) @@ -62,9 +63,11 @@ public function showLoginForm(Repository $config) /** * Handle a login request to the application. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return mixed + * * @throws \Illuminate\Validation\ValidationException + * * @author Seven Du */ public function login(Request $request) @@ -88,6 +91,7 @@ public function login(Request $request) * Get the login username to be used by the controller. * * @return string + * * @author Seven Du */ protected function username(): string @@ -101,6 +105,7 @@ protected function username(): string * Get the post register / login redirect path. * * @return string + * * @author Seven Du */ protected function redirectTo(): string diff --git a/app/Http/Controllers/HomeController.php b/app/Http/Controllers/HomeController.php index 81451329b..69c717458 100644 --- a/app/Http/Controllers/HomeController.php +++ b/app/Http/Controllers/HomeController.php @@ -28,8 +28,9 @@ class HomeController /** * Home page. * - * @param \Jenssegers\Agent\Agent $agent + * @param \Jenssegers\Agent\Agent $agent * @return mixed + * * @author Seven Du */ public function welcome(Agent $agent) @@ -49,8 +50,9 @@ public function welcome(Agent $agent) /** * Redirect URL. - * @param \Illuminate\Http\Request $request - * @param \Jenssegers\Agent\Agent $agent + * + * @param \Illuminate\Http\Request $request + * @param \Jenssegers\Agent\Agent $agent * @return mixed */ public function redirect(Request $request, Agent $agent) diff --git a/app/Http/Middleware/RedirectIfAuthenticated.php b/app/Http/Middleware/RedirectIfAuthenticated.php index f0ae70bfe..8bb9640e0 100644 --- a/app/Http/Middleware/RedirectIfAuthenticated.php +++ b/app/Http/Middleware/RedirectIfAuthenticated.php @@ -52,6 +52,7 @@ public function handle(Request $request, Closure $next, ...$guards) * logged in redirect path. * * @return string + * * @author Seven Du */ protected function redirectTo(): string diff --git a/app/Http/Middleware/SensitiveOperation.php b/app/Http/Middleware/SensitiveOperation.php index ccf709353..5e28d4741 100644 --- a/app/Http/Middleware/SensitiveOperation.php +++ b/app/Http/Middleware/SensitiveOperation.php @@ -28,8 +28,9 @@ class SensitiveOperation * 对敏感操作验证用户密码是否正确. * * @param $request - * @param Closure $next + * @param Closure $next * @return mixed + * * @author BS <414606094@qq.com> */ public function handle($request, Closure $next) diff --git a/app/Http/Middleware/UserAbility.php b/app/Http/Middleware/UserAbility.php index be63754e2..517b73e6b 100644 --- a/app/Http/Middleware/UserAbility.php +++ b/app/Http/Middleware/UserAbility.php @@ -31,7 +31,7 @@ class UserAbility /** * Creates a new instance of the middleware. * - * @param Guard $auth + * @param Guard $auth */ public function __construct(Guard $auth) { @@ -41,10 +41,11 @@ public function __construct(Guard $auth) /** * Handle an incoming request. * - * @param \Illuminate\Http\Request $request - * @param \Closure $next - * @param string $ability + * @param \Illuminate\Http\Request $request + * @param \Closure $next + * @param string $ability * @return mixed + * * @author Seven Du */ public function handle(Request $request, Closure $next, string $ability, string $message = '') diff --git a/app/Http/Middleware/VerifyUserPassword.php b/app/Http/Middleware/VerifyUserPassword.php index 60dce6195..0a5bfe2a4 100644 --- a/app/Http/Middleware/VerifyUserPassword.php +++ b/app/Http/Middleware/VerifyUserPassword.php @@ -31,6 +31,7 @@ class VerifyUserPassword { /** * The user guard. + * * @var \Illuminate\Contracts\Auth\Guard */ protected $auth; @@ -38,7 +39,7 @@ class VerifyUserPassword /** * Creates a new instance of the middleware. * - * @param Guard $auth + * @param Guard $auth */ public function __construct(Guard $auth) { @@ -47,9 +48,11 @@ public function __construct(Guard $auth) /** * The middleware handler. - * @param \Illuminate\Http\Request $request - * @param \Closure $next + * + * @param \Illuminate\Http\Request $request + * @param \Closure $next * @return mixed + * * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException * @throws \Symfony\Component\HttpKernel\Exception\UnauthorizedHttpException */ diff --git a/app/Http/Requests/API2/CreateRegisterVerifyCodeRequest.php b/app/Http/Requests/API2/CreateRegisterVerifyCodeRequest.php index e5599e838..10e9cc439 100644 --- a/app/Http/Requests/API2/CreateRegisterVerifyCodeRequest.php +++ b/app/Http/Requests/API2/CreateRegisterVerifyCodeRequest.php @@ -51,6 +51,7 @@ public function rules() * Get the validation messages. * * @return array + * * @author Seven Du */ public function messages() diff --git a/app/Http/Requests/API2/NewStoreUserWallerCashPost.php b/app/Http/Requests/API2/NewStoreUserWallerCashPost.php index a4448e152..2801b031e 100644 --- a/app/Http/Requests/API2/NewStoreUserWallerCashPost.php +++ b/app/Http/Requests/API2/NewStoreUserWallerCashPost.php @@ -65,6 +65,7 @@ public function rules(): array * Get rule messages. * * @return array + * * @author Seven Du */ public function messages() diff --git a/app/Http/Requests/API2/NewStoreWalletRecharge.php b/app/Http/Requests/API2/NewStoreWalletRecharge.php index bca54937b..5544af98e 100644 --- a/app/Http/Requests/API2/NewStoreWalletRecharge.php +++ b/app/Http/Requests/API2/NewStoreWalletRecharge.php @@ -39,6 +39,7 @@ public function authorize() * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules() @@ -54,6 +55,7 @@ public function rules() * Get the valodation error message that apply to the request. * * @return array + * * @author Seven Du */ public function messages() diff --git a/app/Http/Requests/API2/StoreCurrencyAppleIAPRecharge.php b/app/Http/Requests/API2/StoreCurrencyAppleIAPRecharge.php index a2eb98594..7bfd5ecfc 100644 --- a/app/Http/Requests/API2/StoreCurrencyAppleIAPRecharge.php +++ b/app/Http/Requests/API2/StoreCurrencyAppleIAPRecharge.php @@ -39,6 +39,7 @@ public function authorize() * Get the validation rules that apply to the request. * * @return array + * * @author BS <414606094@qq.com> */ public function rules() @@ -62,6 +63,7 @@ public function rules() * Get the valodation error message that apply to the request. * * @return array + * * @author BS <414606094@qq.com> */ public function messages() diff --git a/app/Http/Requests/API2/StoreCurrencyCash.php b/app/Http/Requests/API2/StoreCurrencyCash.php index ed59de619..13a6fa7fe 100644 --- a/app/Http/Requests/API2/StoreCurrencyCash.php +++ b/app/Http/Requests/API2/StoreCurrencyCash.php @@ -39,6 +39,7 @@ public function authorize() * Get the validation rules that apply to the request. * * @return array + * * @author BS <414606094@qq.com> */ public function rules() @@ -63,6 +64,7 @@ public function rules() * Get the valodation error message that apply to the request. * * @return array + * * @author BS <414606094@qq.com> */ public function messages() diff --git a/app/Http/Requests/API2/StoreCurrencyRecharge.php b/app/Http/Requests/API2/StoreCurrencyRecharge.php index 11ce8abf0..8529dd4fa 100644 --- a/app/Http/Requests/API2/StoreCurrencyRecharge.php +++ b/app/Http/Requests/API2/StoreCurrencyRecharge.php @@ -39,6 +39,7 @@ public function authorize() * Get the validation rules that apply to the request. * * @return array + * * @author BS <414606094@qq.com> */ public function rules() @@ -67,6 +68,7 @@ public function rules() * Get the valodation error message that apply to the request. * * @return array + * * @author BS <414606094@qq.com> */ public function messages() diff --git a/app/Http/Requests/API2/StoreTag.php b/app/Http/Requests/API2/StoreTag.php index fff1557b5..831c3df3b 100644 --- a/app/Http/Requests/API2/StoreTag.php +++ b/app/Http/Requests/API2/StoreTag.php @@ -55,6 +55,7 @@ public function rules(): array * Get the validation message that apply to the request. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/app/Http/Requests/API2/StoreTransform.php b/app/Http/Requests/API2/StoreTransform.php index 9f8347dbb..814ab9ab4 100644 --- a/app/Http/Requests/API2/StoreTransform.php +++ b/app/Http/Requests/API2/StoreTransform.php @@ -39,6 +39,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author BS <414606094@qq.com> */ public function rules(): array @@ -60,6 +61,7 @@ public function rules(): array * Get the valodation error message that apply to the request. * * @return array + * * @author BS <414606094@qq.com> */ public function messages(): array diff --git a/app/Http/Requests/API2/StoreUploadFile.php b/app/Http/Requests/API2/StoreUploadFile.php index 448ac0b96..7969d5a46 100644 --- a/app/Http/Requests/API2/StoreUploadFile.php +++ b/app/Http/Requests/API2/StoreUploadFile.php @@ -53,6 +53,7 @@ public function rules() * Get the validation message that apply to the request. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/app/Http/Requests/API2/StoreUserPost.php b/app/Http/Requests/API2/StoreUserPost.php index 09d7ddde8..ceed7e94d 100644 --- a/app/Http/Requests/API2/StoreUserPost.php +++ b/app/Http/Requests/API2/StoreUserPost.php @@ -62,6 +62,7 @@ public function rules() * Get rule messages. * * @return array + * * @author Seven Du */ public function messages() diff --git a/app/Http/Requests/API2/StoreUserWallerCashPost.php b/app/Http/Requests/API2/StoreUserWallerCashPost.php index 82a2047e2..04ec8af06 100644 --- a/app/Http/Requests/API2/StoreUserWallerCashPost.php +++ b/app/Http/Requests/API2/StoreUserWallerCashPost.php @@ -62,6 +62,7 @@ public function rules() * Get rule messages. * * @return array + * * @author Seven Du */ public function messages() diff --git a/app/Http/Requests/API2/StoreVerifyCode.php b/app/Http/Requests/API2/StoreVerifyCode.php index 1bcf827d3..3cf40eb6c 100644 --- a/app/Http/Requests/API2/StoreVerifyCode.php +++ b/app/Http/Requests/API2/StoreVerifyCode.php @@ -51,6 +51,7 @@ public function rules(): array * Get the validation messages. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/app/Http/Requests/API2/StoreWalletRecharge.php b/app/Http/Requests/API2/StoreWalletRecharge.php index eec81d1c8..0cb0e9555 100644 --- a/app/Http/Requests/API2/StoreWalletRecharge.php +++ b/app/Http/Requests/API2/StoreWalletRecharge.php @@ -39,6 +39,7 @@ public function authorize() * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules() @@ -53,6 +54,7 @@ public function rules() * Get the valodation error message that apply to the request. * * @return array + * * @author Seven Du */ public function messages() diff --git a/app/Http/Requests/API2/Transfer.php b/app/Http/Requests/API2/Transfer.php index 5a8e2789b..15e35ceb1 100644 --- a/app/Http/Requests/API2/Transfer.php +++ b/app/Http/Requests/API2/Transfer.php @@ -60,6 +60,7 @@ public function rules() * Get rule messages. * * @return array + * * @author Seven Du */ public function messages() diff --git a/app/Http/Requests/API2/UpdateTag.php b/app/Http/Requests/API2/UpdateTag.php index a057d15d1..9652f7c9f 100644 --- a/app/Http/Requests/API2/UpdateTag.php +++ b/app/Http/Requests/API2/UpdateTag.php @@ -56,6 +56,7 @@ public function rules(): array * Get the validation message that apply to the request. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/app/Http/Requests/Admin/CreateSensitive.php b/app/Http/Requests/Admin/CreateSensitive.php index a022abdc3..0f11d89e2 100644 --- a/app/Http/Requests/Admin/CreateSensitive.php +++ b/app/Http/Requests/Admin/CreateSensitive.php @@ -28,6 +28,7 @@ class CreateSensitive extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/app/Http/Requests/Admin/UpdateCorsRequest.php b/app/Http/Requests/Admin/UpdateCorsRequest.php index aa34d16d0..fab3505cb 100644 --- a/app/Http/Requests/Admin/UpdateCorsRequest.php +++ b/app/Http/Requests/Admin/UpdateCorsRequest.php @@ -28,6 +28,7 @@ class UpdateCorsRequest extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/app/Http/Requests/Admin/UpdateSensitive.php b/app/Http/Requests/Admin/UpdateSensitive.php index f7324a1c5..2a30b9596 100644 --- a/app/Http/Requests/Admin/UpdateSensitive.php +++ b/app/Http/Requests/Admin/UpdateSensitive.php @@ -28,6 +28,7 @@ class UpdateSensitive extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/app/Http/Requests/Admin/UpdateWebClientRequest.php b/app/Http/Requests/Admin/UpdateWebClientRequest.php index cecee0883..17258992c 100644 --- a/app/Http/Requests/Admin/UpdateWebClientRequest.php +++ b/app/Http/Requests/Admin/UpdateWebClientRequest.php @@ -28,6 +28,7 @@ class UpdateWebClientRequest extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/app/Listeners/VerificationCode.php b/app/Listeners/VerificationCode.php index bad2c145d..bb34d2479 100644 --- a/app/Listeners/VerificationCode.php +++ b/app/Listeners/VerificationCode.php @@ -29,7 +29,7 @@ class VerificationCode implements ShouldQueue /** * Handle the event. * - * @param \Illuminate\Notifications\Events\NotificationSent $event + * @param \Illuminate\Notifications\Events\NotificationSent $event * @return void */ public function handle(NotificationSent $event) @@ -43,9 +43,10 @@ public function handle(NotificationSent $event) /** * Failed handle the event. * - * @param \Illuminate\Notifications\Events\NotificationSent $event - * @param mixed $exception + * @param \Illuminate\Notifications\Events\NotificationSent $event + * @param mixed $exception * @return void + * * @author Seven Du */ public function failed(NotificationSent $event, $exception) @@ -61,8 +62,9 @@ public function failed(NotificationSent $event, $exception) /** * Validate the event notifiable instance of verification code model. * - * @param mixed $notifiable + * @param mixed $notifiable * @return bool + * * @author Seven Du */ protected function validate($notifiable): bool diff --git a/app/Models/Ability.php b/app/Models/Ability.php index bae2a4070..bf0d26612 100644 --- a/app/Models/Ability.php +++ b/app/Models/Ability.php @@ -32,6 +32,7 @@ * @property string|null $description * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|Ability newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Ability newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Ability query() diff --git a/app/Models/Advertising.php b/app/Models/Advertising.php index 8e0c3cb04..c4bda7828 100644 --- a/app/Models/Advertising.php +++ b/app/Models/Advertising.php @@ -34,6 +34,7 @@ * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Zhiyi\Plus\Models\AdvertisingSpace $space + * * @method static \Illuminate\Database\Eloquent\Builder|Advertising newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Advertising newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Advertising query() diff --git a/app/Models/AdvertisingSpace.php b/app/Models/AdvertisingSpace.php index 3d374bc2d..d4c51ffd9 100644 --- a/app/Models/AdvertisingSpace.php +++ b/app/Models/AdvertisingSpace.php @@ -37,6 +37,7 @@ * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Illuminate\Database\Eloquent\Collection|\Zhiyi\Plus\Models\Advertising[] $advertising * @property-read int|null $advertising_count + * * @method static \Illuminate\Database\Eloquent\Builder|AdvertisingSpace newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|AdvertisingSpace newQuery() * @method static \Illuminate\Database\Eloquent\Builder|AdvertisingSpace query() diff --git a/app/Models/Area.php b/app/Models/Area.php index a12dc60c1..52870bb88 100644 --- a/app/Models/Area.php +++ b/app/Models/Area.php @@ -35,6 +35,7 @@ * @property-read \Illuminate\Database\Eloquent\Collection|Area[] $items * @property-read int|null $items_count * @property-read Area|null $parent + * * @method static Builder|Area byPid($pid) * @method static Builder|Area newModelQuery() * @method static Builder|Area newQuery() @@ -52,9 +53,8 @@ class Area extends Model /** * Scope func by pid. * - * @param Builder $query - * @param int $pid - * + * @param Builder $query + * @param int $pid * @return Illuminate\Database\Eloquent\Builder * * @author Seven Du diff --git a/app/Models/BlackList.php b/app/Models/BlackList.php index d855f72f5..8d54dd548 100644 --- a/app/Models/BlackList.php +++ b/app/Models/BlackList.php @@ -30,6 +30,7 @@ * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Zhiyi\Plus\Models\User|null $user + * * @method static \Illuminate\Database\Eloquent\Builder|BlackList newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|BlackList newQuery() * @method static \Illuminate\Database\Eloquent\Builder|BlackList query() diff --git a/app/Models/Certification.php b/app/Models/Certification.php index 5beaf997b..adb1e8d7e 100644 --- a/app/Models/Certification.php +++ b/app/Models/Certification.php @@ -38,6 +38,7 @@ * @property-read \Zhiyi\Plus\Models\CertificationCategory|null $category * @property-read string|null $icon * @property-read \Zhiyi\Plus\Models\User $user + * * @method static Builder|Certification newModelQuery() * @method static Builder|Certification newQuery() * @method static Builder|Certification query() @@ -104,6 +105,7 @@ public static function boot() * Get icon url. * * @return string|null + * * @author Seven Du */ public function getIconAttribute() @@ -115,6 +117,7 @@ public function getIconAttribute() * Get avatar trait. * * @return string|int + * * @author Seven Du */ public function getAvatarKey() @@ -126,6 +129,7 @@ public function getAvatarKey() * avatar extensions. * * @return array + * * @author Seven Du */ public function getAvatarExtensions(): array @@ -137,6 +141,7 @@ public function getAvatarExtensions(): array * Avatar prefix. * * @return string + * * @author Seven Du */ public function getAvatarPrefix(): string @@ -148,6 +153,7 @@ public function getAvatarPrefix(): string * Has certification caregory. * * @return HasOne + * * @author Seven Du */ public function category() diff --git a/app/Models/CertificationCategory.php b/app/Models/CertificationCategory.php index 10b5d0561..c833815c4 100644 --- a/app/Models/CertificationCategory.php +++ b/app/Models/CertificationCategory.php @@ -29,6 +29,7 @@ * @property string $display_name * @property string|null $description * @property-read string|null $icon + * * @method static \Illuminate\Database\Eloquent\Builder|CertificationCategory newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|CertificationCategory newQuery() * @method static \Illuminate\Database\Eloquent\Builder|CertificationCategory query() @@ -73,6 +74,7 @@ class CertificationCategory extends Model * avatar extensions. * * @return array + * * @author Seven Du */ public function getAvatarExtensions(): array @@ -84,6 +86,7 @@ public function getAvatarExtensions(): array * Avatar prefix. * * @return string + * * @author Seven Du */ public function getAvatarPrefix(): string @@ -95,6 +98,7 @@ public function getAvatarPrefix(): string * Get icon url. * * @return string|null + * * @author Seven Du */ public function getIconAttribute() @@ -106,6 +110,7 @@ public function getIconAttribute() * Get avatar trait. * * @return string|int + * * @author Seven Du */ public function getAvatarKey() diff --git a/app/Models/Collection.php b/app/Models/Collection.php index 9e29c2981..838e788a8 100644 --- a/app/Models/Collection.php +++ b/app/Models/Collection.php @@ -32,6 +32,7 @@ * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at * @property-read Model|\Eloquent $collectible + * * @method static \Illuminate\Database\Eloquent\Builder|Collection newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Collection newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Collection query() @@ -56,6 +57,7 @@ class Collection extends Model * Has collectible. * * @return \Illuminate\Database\Eloquent\Relations\MorphTo + * * @author Seven Du */ public function collectible() diff --git a/app/Models/Comment.php b/app/Models/Comment.php index 5b80645e6..68c280011 100644 --- a/app/Models/Comment.php +++ b/app/Models/Comment.php @@ -47,6 +47,7 @@ * @property-read int|null $reports_count * @property-read \Zhiyi\Plus\Models\User $target * @property-read \Zhiyi\Plus\Models\User $user + * * @method static Builder|Comment newModelQuery() * @method static Builder|Comment newQuery() * @method static Builder|Comment query() @@ -84,6 +85,7 @@ public static function boot() * Has commentable. * * @return MorphTo + * * @author Seven Du */ public function commentable() @@ -95,6 +97,7 @@ public function commentable() * Has a user. * * @return BelongsTo + * * @author Seven Du */ public function user() @@ -109,6 +112,7 @@ public function user() * @Author Wayne * @DateTime 2018-04-14 * @Email qiaobin@zhiyicx.com + * * @return BelongsTo */ public function target() @@ -127,6 +131,7 @@ public function blacks() * @Author Wayne * @DateTime 2018-04-14 * @Email qiaobin@zhiyicx.com + * * @return BelongsTo */ public function reply() @@ -138,6 +143,7 @@ public function reply() * 被举报记录. * * @return MorphMany + * * @author BS <414606094@qq.com> */ public function reports() diff --git a/app/Models/CommonConfig.php b/app/Models/CommonConfig.php index a76092157..c4467ed41 100644 --- a/app/Models/CommonConfig.php +++ b/app/Models/CommonConfig.php @@ -32,6 +32,7 @@ * @property string|null $value 缓存值 * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static Builder|CommonConfig byName($name) * @method static Builder|CommonConfig byNamespace($namespace) * @method static Builder|CommonConfig newModelQuery() @@ -54,9 +55,8 @@ class CommonConfig extends Model /** * Scope func to namespace. * - * @param Illuminate\Database\Eloquent\Builder $query - * @param string $namespace - * + * @param Illuminate\Database\Eloquent\Builder $query + * @param string $namespace * @return Illuminate\Database\Eloquent\Builder * * @author Seven Du @@ -70,9 +70,8 @@ public function scopeByNamespace(Builder $query, string $namespace): Builder /** * Scope func to name. * - * @param Illuminate\Database\Eloquent\Builder $query - * @param string $name - * + * @param Illuminate\Database\Eloquent\Builder $query + * @param string $name * @return Illuminate\Database\Eloquent\Builder * * @author Seven Du diff --git a/app/Models/Concerns/HasAvatar.php b/app/Models/Concerns/HasAvatar.php index 8c9013db1..0f13c17e5 100644 --- a/app/Models/Concerns/HasAvatar.php +++ b/app/Models/Concerns/HasAvatar.php @@ -35,6 +35,7 @@ trait HasAvatar * Get avatar trait. * * @return string|int + * * @author Seven Du */ abstract public function getAvatarKey(): string; @@ -43,6 +44,7 @@ abstract public function getAvatarKey(): string; * avatar extensions. * * @return array + * * @author Seven Du */ public function getAvatarExtensions(): array @@ -54,6 +56,7 @@ public function getAvatarExtensions(): array * Avatar prefix. * * @return string + * * @author Seven Du */ public function getAvatarPrefix(): string @@ -64,9 +67,10 @@ public function getAvatarPrefix(): string /** * Get avatar,. * - * @param int $size - * @param string $prefix + * @param int $size + * @param string $prefix * @return mixed + * * @author Seven Du */ public function avatar(int $size = 0, string $prefix = '') @@ -86,8 +90,9 @@ public function avatar(int $size = 0, string $prefix = '') /** * Get avatar file path. * - * @param string $prefix + * @param string $prefix * @return string|null + * * @author Seven Du */ public function avatarPath(string $prefix = '') @@ -109,8 +114,9 @@ public function avatarPath(string $prefix = '') /** * Store avatar. * - * @param UploadedFile $avatar + * @param UploadedFile $avatar * @return string|false + * * @author Seven Du */ public function storeAvatar(UploadedFile $avatar, string $prefix = '') @@ -146,6 +152,7 @@ public function storeAvatar(UploadedFile $avatar, string $prefix = '') * make avatar file path. * * @return string + * * @author Seven Du */ protected function makeAvatarPath(string $prefix = ''): string @@ -169,6 +176,7 @@ protected function makeAvatarPath(string $prefix = ''): string * Get filesystem. * * @return \Illuminate\Filesystem\FilesystemManager + * * @author Seven Du */ protected function filesystem(): FilesystemManager diff --git a/app/Models/Concerns/Macroable.php b/app/Models/Concerns/Macroable.php index bd1682589..d3792a4b2 100644 --- a/app/Models/Concerns/Macroable.php +++ b/app/Models/Concerns/Macroable.php @@ -29,8 +29,9 @@ trait Macroable /** * Get a relationship value from a method. * - * @param string $key + * @param string $key * @return mixed + * * @author Seven Du */ public function getRelationValue($key) @@ -46,9 +47,10 @@ public function getRelationValue($key) /** * Handle dynamic method calls into the model. * - * @param string $method - * @param array $parameters + * @param string $method + * @param array $parameters * @return mixed + * * @author Seven Du */ public function __call($method, $parameters) diff --git a/app/Models/Concerns/UserHasAbility.php b/app/Models/Concerns/UserHasAbility.php index a32bf6d7a..89c9ba7f6 100644 --- a/app/Models/Concerns/UserHasAbility.php +++ b/app/Models/Concerns/UserHasAbility.php @@ -35,11 +35,12 @@ trait UserHasAbility /** * User ability. * - * @param array $parameters - * ability(); - * ability($ability); - * ability($role, $ability); + * @param array $parameters + * ability(); + * ability($ability); + * ability($role, $ability); * @return mixed + * * @author Seven Du */ public function ability(...$parameters) @@ -59,8 +60,9 @@ public function ability(...$parameters) /** * The user all roles. * - * @param string $role + * @param string $role * @return mied + * * @author Seven Du */ public function roles(string $role = '') @@ -76,6 +78,7 @@ public function roles(string $role = '') * Resolve ability service. * * @return \Zhiyi\Plus\Services\UserAbility + * * @author Seven Du */ protected function resolveAbility() diff --git a/app/Models/Conversation.php b/app/Models/Conversation.php index cdf0af066..1560c1cd6 100644 --- a/app/Models/Conversation.php +++ b/app/Models/Conversation.php @@ -36,6 +36,7 @@ * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Zhiyi\Plus\Models\User|null $target * @property-read \Zhiyi\Plus\Models\User|null $user + * * @method static \Illuminate\Database\Eloquent\Builder|Conversation newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Conversation newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Conversation query() diff --git a/app/Models/Currency.php b/app/Models/Currency.php index 52c97f508..75219917e 100644 --- a/app/Models/Currency.php +++ b/app/Models/Currency.php @@ -30,6 +30,7 @@ * @property int $sum 货币总和 * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|Currency newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Currency newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Currency query() diff --git a/app/Models/CurrencyCommodity.php b/app/Models/CurrencyCommodity.php index 88cb8fafc..062c95264 100644 --- a/app/Models/CurrencyCommodity.php +++ b/app/Models/CurrencyCommodity.php @@ -34,6 +34,7 @@ * @property int $purchase_count 购买统计 * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|CurrencyCommodity newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|CurrencyCommodity newQuery() * @method static \Illuminate\Database\Eloquent\Builder|CurrencyCommodity query() diff --git a/app/Models/CurrencyOrder.php b/app/Models/CurrencyOrder.php index 189ef2a7b..7b14b3858 100644 --- a/app/Models/CurrencyOrder.php +++ b/app/Models/CurrencyOrder.php @@ -38,6 +38,7 @@ * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Zhiyi\Plus\Models\User|null $user + * * @method static \Illuminate\Database\Eloquent\Builder|CurrencyOrder newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|CurrencyOrder newQuery() * @method static \Illuminate\Database\Eloquent\Builder|CurrencyOrder query() @@ -61,6 +62,7 @@ class CurrencyOrder extends Model * the owner of order. * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author BS <414606094@qq.com> */ public function user() diff --git a/app/Models/CurrencyType.php b/app/Models/CurrencyType.php index 691726f89..50c3d9b0a 100644 --- a/app/Models/CurrencyType.php +++ b/app/Models/CurrencyType.php @@ -31,6 +31,7 @@ * @property string $name 货币名称 * @property string $unit 货币单位 * @property int|null $enable 货币是否被启用 + * * @method static \Illuminate\Database\Eloquent\Builder|CurrencyType newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|CurrencyType newQuery() * @method static \Illuminate\Database\Eloquent\Builder|CurrencyType query() @@ -53,7 +54,6 @@ class CurrencyType extends Model * 获取当前使用的积分名称. * * @param null $field - * * @return mixed */ public static function current($field = null) diff --git a/app/Models/CurrencyTypeTransform.php b/app/Models/CurrencyTypeTransform.php index 00523e898..3b748f169 100644 --- a/app/Models/CurrencyTypeTransform.php +++ b/app/Models/CurrencyTypeTransform.php @@ -29,6 +29,7 @@ * @property int $to_type_id 目标货币类型 * @property int $form_sum 原始货币数量 * @property int $to_sum 目标货币数量 + * * @method static \Illuminate\Database\Eloquent\Builder|CurrencyTypeTransform newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|CurrencyTypeTransform newQuery() * @method static \Illuminate\Database\Eloquent\Builder|CurrencyTypeTransform query() diff --git a/app/Models/Famous.php b/app/Models/Famous.php index f05f827b7..24f9dbc55 100644 --- a/app/Models/Famous.php +++ b/app/Models/Famous.php @@ -31,6 +31,7 @@ * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Zhiyi\Plus\Models\User $user + * * @method static \Illuminate\Database\Eloquent\Builder|Famous newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Famous newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Famous query() diff --git a/app/Models/FeedTopic.php b/app/Models/FeedTopic.php index bd5b414c8..ac12c3943 100644 --- a/app/Models/FeedTopic.php +++ b/app/Models/FeedTopic.php @@ -48,6 +48,7 @@ * @property-read int|null $reports_count * @property-read \Illuminate\Database\Eloquent\Collection|\Zhiyi\Plus\Models\User[] $users * @property-read int|null $users_count + * * @method static \Illuminate\Database\Eloquent\Builder|FeedTopic newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|FeedTopic newQuery() * @method static \Illuminate\Database\Eloquent\Builder|FeedTopic query() @@ -79,7 +80,8 @@ class FeedTopic extends Model /** * Parse resource and get resource meta. - * @param null|string $resource + * + * @param null|string $resource * @return null|\Zhiyi\Plus\FileStorage\FileMetaInterface */ protected function getLogoAttribute(?string $resource = null): ?FileMetaInterface @@ -93,6 +95,7 @@ protected function getLogoAttribute(?string $resource = null): ?FileMetaInterfac /** * Set logo attribute. + * * @param mixed * @return self */ @@ -120,6 +123,7 @@ public function users(): BelongsToMany /** * The model feed velongs ti many relation. + * * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany */ public function feeds(): BelongsToMany @@ -133,6 +137,7 @@ public function feeds(): BelongsToMany /** * The topic creator has one relation. + * * @return \Illuminate\Database\Eloquent\Relations\HasOne */ public function creator(): HasOne diff --git a/app/Models/FeedTopicLink.php b/app/Models/FeedTopicLink.php index f101488ad..c98ab3aae 100644 --- a/app/Models/FeedTopicLink.php +++ b/app/Models/FeedTopicLink.php @@ -31,6 +31,7 @@ * @property int $topic_id Topic ID * @property int $feed_id Feed ID * @property-read FeedModel|null $feed + * * @method static \Illuminate\Database\Eloquent\Builder|FeedTopicLink newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|FeedTopicLink newQuery() * @method static \Illuminate\Database\Eloquent\Builder|FeedTopicLink query() diff --git a/app/Models/FeedTopicUserLink.php b/app/Models/FeedTopicUserLink.php index ee5e269ad..11de4aa23 100644 --- a/app/Models/FeedTopicUserLink.php +++ b/app/Models/FeedTopicUserLink.php @@ -32,6 +32,7 @@ * @property string|null $following_at * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|FeedTopicUserLink newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|FeedTopicUserLink newQuery() * @method static \Illuminate\Database\Eloquent\Builder|FeedTopicUserLink query() diff --git a/app/Models/File.php b/app/Models/File.php index e3b36d9fc..1ec3924ff 100644 --- a/app/Models/File.php +++ b/app/Models/File.php @@ -34,6 +34,7 @@ * @property float $height 图片高度 * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|File newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|File newQuery() * @method static \Illuminate\Database\Eloquent\Builder|File query() diff --git a/app/Models/FileWith.php b/app/Models/FileWith.php index 90edcce04..fa221c508 100644 --- a/app/Models/FileWith.php +++ b/app/Models/FileWith.php @@ -39,6 +39,7 @@ * @property-read \Zhiyi\Plus\Models\File|null $file * @property-read string $pay_index * @property-read \Zhiyi\Plus\Models\PaidNode|null $paidNode + * * @method static Builder|FileWith newModelQuery() * @method static Builder|FileWith newQuery() * @method static Builder|FileWith query() @@ -79,6 +80,7 @@ public function getPayIndexAttribute(): string * has file. * * @return HasOne + * * @author Seven Du */ public function file() @@ -90,6 +92,7 @@ public function file() * 获取付费节点. * * @return HasOne + * * @author Seven Du */ public function paidNode() diff --git a/app/Models/GoldRule.php b/app/Models/GoldRule.php index 1e29296f5..b3f6ef818 100644 --- a/app/Models/GoldRule.php +++ b/app/Models/GoldRule.php @@ -32,6 +32,7 @@ * @property int $incremental 金币规则增量 * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|GoldRule newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|GoldRule newQuery() * @method static \Illuminate\Database\Eloquent\Builder|GoldRule query() diff --git a/app/Models/GoldType.php b/app/Models/GoldType.php index 907e13aca..ed5855c6c 100644 --- a/app/Models/GoldType.php +++ b/app/Models/GoldType.php @@ -33,6 +33,7 @@ * @property int $status 状态:1-开启 0-关闭 * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|GoldType newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|GoldType newQuery() * @method static \Illuminate\Database\Eloquent\Builder|GoldType query() @@ -54,7 +55,6 @@ class GoldType extends Model * 获取当前使用的积分名称. * * @param null $field - * * @return mixed */ public static function current($field = null) diff --git a/app/Models/ImGroup.php b/app/Models/ImGroup.php index 8f18e70f0..b0a5624c6 100644 --- a/app/Models/ImGroup.php +++ b/app/Models/ImGroup.php @@ -35,6 +35,7 @@ * @property string|null $deleted_at * @property-read \Zhiyi\Plus\Models\FileWith|null $face * @property-read \Zhiyi\Plus\Models\User|null $owner + * * @method static \Illuminate\Database\Eloquent\Builder|ImGroup newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|ImGroup newQuery() * @method static \Illuminate\Database\Eloquent\Builder|ImGroup query() diff --git a/app/Models/Like.php b/app/Models/Like.php index e6e451ebf..66a4e35d5 100644 --- a/app/Models/Like.php +++ b/app/Models/Like.php @@ -34,6 +34,7 @@ * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Illuminate\Database\Eloquent\Model|\Eloquent $likeable * @property-read \Zhiyi\Plus\Models\User|null $user + * * @method static \Illuminate\Database\Eloquent\Builder|Like newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Like newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Like query() @@ -64,6 +65,7 @@ class Like extends Pivot * Has likeable. * * @return \Illuminate\Database\Eloquent\Relations\MorphTo + * * @author Seven Du */ public function likeable() @@ -75,6 +77,7 @@ public function likeable() * Has user of the likeable. * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author Seven Du */ public function user() diff --git a/app/Models/NativePayOrder.php b/app/Models/NativePayOrder.php index bd9c7bb35..d3c86bdd3 100644 --- a/app/Models/NativePayOrder.php +++ b/app/Models/NativePayOrder.php @@ -38,6 +38,7 @@ * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Zhiyi\Plus\Models\User $user * @property-read \Zhiyi\Plus\Models\WalletCharge|null $walletCharge + * * @method static \Illuminate\Database\Eloquent\Builder|NativePayOrder newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|NativePayOrder newQuery() * @method static \Illuminate\Database\Eloquent\Builder|NativePayOrder query() diff --git a/app/Models/NewWallet.php b/app/Models/NewWallet.php index c2d137a22..caf2377ea 100644 --- a/app/Models/NewWallet.php +++ b/app/Models/NewWallet.php @@ -33,6 +33,7 @@ * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Zhiyi\Plus\Models\User|null $owner + * * @method static \Illuminate\Database\Eloquent\Builder|NewWallet newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|NewWallet newQuery() * @method static \Illuminate\Database\Eloquent\Builder|NewWallet query() @@ -80,6 +81,7 @@ class NewWallet extends Model * The wallet owner. * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author Seven Du */ public function owner(): HasOne diff --git a/app/Models/PaidNode.php b/app/Models/PaidNode.php index aed547413..486766250 100644 --- a/app/Models/PaidNode.php +++ b/app/Models/PaidNode.php @@ -40,6 +40,7 @@ * @property-read int|null $users_count * @property-read \Illuminate\Database\Eloquent\Collection|\Zhiyi\Plus\Models\Wallet[] $wallet * @property-read int|null $wallet_count + * * @method static \Illuminate\Database\Eloquent\Builder|PaidNode newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|PaidNode newQuery() * @method static \Illuminate\Database\Eloquent\Builder|PaidNode query() diff --git a/app/Models/PaidNodeUser.php b/app/Models/PaidNodeUser.php index be27f6799..63eb87291 100644 --- a/app/Models/PaidNodeUser.php +++ b/app/Models/PaidNodeUser.php @@ -27,6 +27,7 @@ * * @property int $node_id 付费发布ID * @property int $user_id 用户ID + * * @method static \Illuminate\Database\Eloquent\Builder|PaidNodeUser newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|PaidNodeUser newQuery() * @method static \Illuminate\Database\Eloquent\Builder|PaidNodeUser query() diff --git a/app/Models/Relations/PaidNodeHasUser.php b/app/Models/Relations/PaidNodeHasUser.php index 3d20a79ff..9855f9810 100644 --- a/app/Models/Relations/PaidNodeHasUser.php +++ b/app/Models/Relations/PaidNodeHasUser.php @@ -40,6 +40,7 @@ public function wallet() * Paid node users. * * @return BelongsToMany + * * @author Seven Du */ public function users() @@ -52,6 +53,7 @@ public function users() * the author of paid. * * @return hasOne + * * @author bs<414606094@qq.com> */ public function user() @@ -64,8 +66,8 @@ public function user() * * @param int $user User ID * @param bool $filter - * * @return bool + * * @author Seven Du */ public function paid(int $user, bool $filter = true): bool diff --git a/app/Models/Relations/UserHasBlackList.php b/app/Models/Relations/UserHasBlackList.php index 1274424f3..b40bd3796 100644 --- a/app/Models/Relations/UserHasBlackList.php +++ b/app/Models/Relations/UserHasBlackList.php @@ -28,10 +28,12 @@ trait UserHasBlackList { /** * get blacklists of current user. + * * @Author Wayne * @DateTime 2018-04-08 * @Email qiaobin@zhiyicx.com - * @return [type] [description] + * + * @return [type] [description] */ public function blacklists() { @@ -40,11 +42,13 @@ public function blacklists() /** * is user blacked by current_user. + * * @Author Wayne * @DateTime 2018-04-18 * @Email qiaobin@zhiyicx.com + * * @param [type] $user [description] - * @return [type] [description] + * @return [type] [description] */ public function blacked($user): bool { diff --git a/app/Models/Relations/UserHasComment.php b/app/Models/Relations/UserHasComment.php index 76aa4ce30..cfc5a6f30 100644 --- a/app/Models/Relations/UserHasComment.php +++ b/app/Models/Relations/UserHasComment.php @@ -28,6 +28,7 @@ trait UserHasComment * Has comments. * * @return \Illuminate\Database\Eloquent\Relations\HasMany + * * @author Seven Du */ public function comments() diff --git a/app/Models/Relations/UserHasFilesWith.php b/app/Models/Relations/UserHasFilesWith.php index f7baba2d3..d05344841 100644 --- a/app/Models/Relations/UserHasFilesWith.php +++ b/app/Models/Relations/UserHasFilesWith.php @@ -28,6 +28,7 @@ trait UserHasFilesWith * user files. * * @return \Illuminate\Database\Eloquent\Relations\HasMany + * * @author Seven Du */ public function files() diff --git a/app/Models/Relations/UserHasFollow.php b/app/Models/Relations/UserHasFollow.php index 36e7ed7f5..99ac57074 100644 --- a/app/Models/Relations/UserHasFollow.php +++ b/app/Models/Relations/UserHasFollow.php @@ -29,6 +29,7 @@ trait UserHasFollow * follows - my following. * * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany + * * @author Seven Du */ public function followings(): BelongsToMany @@ -44,6 +45,7 @@ public function followings(): BelongsToMany * followers - my followers. * * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany + * * @author Seven Du */ public function followers(): BelongsToMany @@ -58,8 +60,9 @@ public function followers(): BelongsToMany /** * Verification is concerned followed. * - * @param int|\Zhiyi\Plus\Models\User $user + * @param int|\Zhiyi\Plus\Models\User $user * @return bool + * * @author Seven Du */ public function hasFollwing($user): bool @@ -81,8 +84,9 @@ public function hasFollwing($user): bool /** * Verify that I am followed. * - * @param int|\Zhiyi\Plus\Models\User $user + * @param int|\Zhiyi\Plus\Models\User $user * @return bool + * * @author Seven Du */ public function hasFollower($user): bool @@ -105,6 +109,7 @@ public function hasFollower($user): bool * 相互关注的好友. * * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany + * * @author ZsyD<1251992018@qq.com> */ public function mutual(): BelongsToMany diff --git a/app/Models/Relations/UserHasLike.php b/app/Models/Relations/UserHasLike.php index a4419ce5c..7e8cdb96e 100644 --- a/app/Models/Relations/UserHasLike.php +++ b/app/Models/Relations/UserHasLike.php @@ -28,6 +28,7 @@ trait UserHasLike * Has likes for user. * * @return \Illuminate\Database\Eloquent\Relations\HasMany + * * @author Seven Du */ public function likes() @@ -39,6 +40,7 @@ public function likes() * Has be likeds for user. * * @return \Illuminate\Database\Eloquent\Relations\HasMany + * * @author Seven Du */ public function belikeds() diff --git a/app/Models/Relations/UserHasNewWallet.php b/app/Models/Relations/UserHasNewWallet.php index 15e323297..d102387c1 100644 --- a/app/Models/Relations/UserHasNewWallet.php +++ b/app/Models/Relations/UserHasNewWallet.php @@ -29,6 +29,7 @@ trait UserHasNewWallet * Bootstrap the trait. * * @return void + * * @author Seven Du */ public static function bootUserHasNewWallet() @@ -57,6 +58,7 @@ public static function bootUserHasNewWallet() * User wallet. * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author BS <414606094@qq.com> */ public function newWallet(): HasOne diff --git a/app/Models/Relations/UserHasReward.php b/app/Models/Relations/UserHasReward.php index 3e0336076..6293727f8 100644 --- a/app/Models/Relations/UserHasReward.php +++ b/app/Models/Relations/UserHasReward.php @@ -29,6 +29,7 @@ trait UserHasReward * 用户的被打赏记录. * * @author bs<414606094@qq.com> + * * @return \Illuminate\Database\Eloquent\Relations\morphMany */ public function beRewardeds() @@ -40,8 +41,9 @@ public function beRewardeds() * 打赏用户. * * @author bs<414606094@qq.com> - * @param mix $user - * @param float $amount + * + * @param mix $user + * @param float $amount * @return mix */ public function reward($user, $amount) diff --git a/app/Models/Relations/UserHasWallet.php b/app/Models/Relations/UserHasWallet.php index d7ff15719..c467d41e1 100644 --- a/app/Models/Relations/UserHasWallet.php +++ b/app/Models/Relations/UserHasWallet.php @@ -29,6 +29,7 @@ trait UserHasWallet * Bootstrap the trait. * * @return void + * * @author Seven Du */ public static function bootUserHasWallet() @@ -55,6 +56,7 @@ public static function bootUserHasWallet() * User wallet. * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author Seven Du */ public function wallet(): HasOne diff --git a/app/Models/Relations/UserHasWalletCash.php b/app/Models/Relations/UserHasWalletCash.php index 3ed2eedbd..c674e035e 100644 --- a/app/Models/Relations/UserHasWalletCash.php +++ b/app/Models/Relations/UserHasWalletCash.php @@ -28,6 +28,7 @@ trait UserHasWalletCash * Wallet cshs. * * @return \Illuminate\Database\Eloquent\Relations\HasMany + * * @author Seven Du */ public function walletCashes() diff --git a/app/Models/Relations/UserHasWalletCharge.php b/app/Models/Relations/UserHasWalletCharge.php index ea985d8a7..f3b300965 100644 --- a/app/Models/Relations/UserHasWalletCharge.php +++ b/app/Models/Relations/UserHasWalletCharge.php @@ -28,6 +28,7 @@ trait UserHasWalletCharge * User wallet charges. * * @return \Illuminate\Database\Eloquent\Relations\HasMany + * * @author Seven Du */ public function walletCharges() diff --git a/app/Models/Report.php b/app/Models/Report.php index 701b166ae..2fab4b470 100644 --- a/app/Models/Report.php +++ b/app/Models/Report.php @@ -39,6 +39,7 @@ * @property-read Model|\Eloquent $reportable * @property-read \Zhiyi\Plus\Models\User|null $target * @property-read \Zhiyi\Plus\Models\User|null $user + * * @method static \Illuminate\Database\Eloquent\Builder|Report newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Report newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Report query() @@ -66,6 +67,7 @@ public function reportable() * 举报者. * * @return hasOne + * * @author BS <414606094@qq.com> */ public function user() @@ -77,6 +79,7 @@ public function user() * 被举报者. * * @return hasOne + * * @author BS <414606094@qq.com> */ public function target() diff --git a/app/Models/Reward.php b/app/Models/Reward.php index 38015dc91..da111dc9d 100644 --- a/app/Models/Reward.php +++ b/app/Models/Reward.php @@ -36,6 +36,7 @@ * @property-read Model|\Eloquent $rewardable * @property-read \Zhiyi\Plus\Models\User|null $target * @property-read \Zhiyi\Plus\Models\User|null $user + * * @method static \Illuminate\Database\Eloquent\Builder|Reward newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Reward newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Reward query() @@ -62,6 +63,7 @@ class Reward extends Model * Has rewardable. * * @return \Illuminate\Database\Eloquent\Relations\MorphTo + * * @author Seven Du */ public function rewardable() @@ -73,6 +75,7 @@ public function rewardable() * Has user for the rewardable. * * @author bs<414606094@qq.com> + * * @return \Illuminate\Database\Eloquent\Relations\HasOne|null */ public function user() diff --git a/app/Models/Role.php b/app/Models/Role.php index 593832b67..9c7d3ee4a 100644 --- a/app/Models/Role.php +++ b/app/Models/Role.php @@ -40,6 +40,7 @@ * @property-read int|null $abilities_count * @property-read \Illuminate\Database\Eloquent\Collection|\Zhiyi\Plus\Models\User[] $users * @property-read int|null $users_count + * * @method static \Illuminate\Database\Eloquent\Builder|Role newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Role newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Role query() @@ -60,6 +61,7 @@ class Role extends Model * Get all abilities of the role. * * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany + * * @author Seven Du */ public function abilities() @@ -71,6 +73,7 @@ public function abilities() * Get all users of the role. * * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany + * * @author Seven Du */ public function users() @@ -81,8 +84,9 @@ public function users() /** * Get or check The role ability. * - * @param string $ability + * @param string $ability * @return false|Ability + * * @author Seven Du */ public function ability(string $ability) diff --git a/app/Models/RoleUser.php b/app/Models/RoleUser.php index 14788dfee..2da2fda52 100644 --- a/app/Models/RoleUser.php +++ b/app/Models/RoleUser.php @@ -27,6 +27,7 @@ * * @property int $user_id * @property int $role_id + * * @method static \Illuminate\Database\Eloquent\Builder|RoleUser newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|RoleUser newQuery() * @method static \Illuminate\Database\Eloquent\Builder|RoleUser query() diff --git a/app/Models/Sensitive.php b/app/Models/Sensitive.php index 8d35dfa2b..3bf7b06b0 100644 --- a/app/Models/Sensitive.php +++ b/app/Models/Sensitive.php @@ -31,6 +31,7 @@ * @property string|null $replace 替换类型需要替换的文本 * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|Sensitive newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Sensitive newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Sensitive query() diff --git a/app/Models/Setting.php b/app/Models/Setting.php index f2baa8c58..e89ceb1be 100644 --- a/app/Models/Setting.php +++ b/app/Models/Setting.php @@ -29,6 +29,7 @@ * @property string|null $contents 配置数据 * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|Setting byName($name) * @method static \Illuminate\Database\Eloquent\Builder|Setting byNamespace($namespace) * @method static \Illuminate\Database\Eloquent\Builder|Setting newModelQuery() @@ -46,6 +47,7 @@ class Setting extends Model { /** * The table name. + * * @var string */ protected $table = 'settings'; diff --git a/app/Models/Tag.php b/app/Models/Tag.php index 8f12b1882..77d60c8c1 100644 --- a/app/Models/Tag.php +++ b/app/Models/Tag.php @@ -35,6 +35,7 @@ * @property-read \Zhiyi\Plus\Models\TagCategory|null $category * @property-read \Illuminate\Database\Eloquent\Collection|\Zhiyi\Plus\Models\Taggable[] $taggable * @property-read int|null $taggable_count + * * @method static \Illuminate\Database\Eloquent\Builder|Tag newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Tag newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Tag query() @@ -60,6 +61,7 @@ class Tag extends Model * Has the category of tag. * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author Seven Du */ public function category() diff --git a/app/Models/TagCategory.php b/app/Models/TagCategory.php index 980262f0d..e326bcdce 100644 --- a/app/Models/TagCategory.php +++ b/app/Models/TagCategory.php @@ -32,6 +32,7 @@ * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Illuminate\Database\Eloquent\Collection|\Zhiyi\Plus\Models\Tag[] $tags * @property-read int|null $tags_count + * * @method static \Illuminate\Database\Eloquent\Builder|TagCategory newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|TagCategory newQuery() * @method static \Illuminate\Database\Eloquent\Builder|TagCategory query() @@ -55,6 +56,7 @@ class TagCategory extends Model * Has tags of the category. * * @return \Illuminate\Database\Eloquent\Relations\HasMany + * * @author Seven Du */ public function tags() diff --git a/app/Models/Taggable.php b/app/Models/Taggable.php index 451494857..3059ceb41 100644 --- a/app/Models/Taggable.php +++ b/app/Models/Taggable.php @@ -31,6 +31,7 @@ * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Zhiyi\Plus\Models\User $user + * * @method static \Illuminate\Database\Eloquent\Builder|Taggable newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Taggable newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Taggable query() diff --git a/app/Models/User.php b/app/Models/User.php index 3ea704411..5accc9e65 100644 --- a/app/Models/User.php +++ b/app/Models/User.php @@ -93,6 +93,7 @@ * @property-read \Zhiyi\Plus\Models\UserUnreadCount|null $unreadCount * @property-read \Illuminate\Database\Eloquent\Collection|\Zhiyi\Plus\Models\WalletCash[] $walletCashes * @property-read int|null $wallet_cashes_count + * * @method static Builder|User byEmail($email) * @method static Builder|User byName($name) * @method static Builder|User byPhone($phone) @@ -201,6 +202,7 @@ protected function routeNotificationForJpush() * Get the identifier that will be stored in the subject claim of the JWT. * * @return mixed + * * @author Seven Du */ public function getJWTIdentifier() @@ -212,6 +214,7 @@ public function getJWTIdentifier() * Return a key value array, containing any custom claims to be added to the JWT. * * @return array + * * @author Seven Du */ public function getJWTCustomClaims() @@ -241,6 +244,7 @@ protected function getBgAttribute(?string $resource): ?FileMetaInterface * Get verifed. * * @return array|null + * * @author Seven Du */ protected function getVerifiedAttribute() @@ -264,6 +268,7 @@ protected function getVerifiedAttribute() * Has user extra. * * @return HasOne + * * @author Seven Du */ public function extra() @@ -275,6 +280,7 @@ public function extra() * Has user certification. * * @return HasOne + * * @author Seven Du */ public function certification() @@ -286,6 +292,7 @@ public function certification() * Has tags of the user. * * @return MorphToMany + * * @author Seven Du */ public function tags() @@ -319,7 +326,6 @@ public function famous() * * @param Illuminate\Database\Eloquent\Builder $query 查询对象 * @param string $phone 手机号码 - * * @return Illuminate\Database\Eloquent\Builder 查询对象 * * @author Seven Du @@ -335,7 +341,6 @@ public function scopeByPhone(Builder $query, string $phone): Builder * * @param Illuminate\Database\Eloquent\Builder $query 查询对象 * @param string $name 用户名 - * * @return Illuminate\Database\Eloquent\Builder 查询对象 * * @author Seven Du @@ -351,8 +356,8 @@ public function scopeByName(Builder $query, string $name): Builder * * @param Illuminate\Database\Eloquent\Builder $query * @param string $email [description] - * * @return Illuminate\Database\Eloquent\Builder + * * @author Seven Du */ public function scopeByEmail(Builder $query, string $email): Builder @@ -364,7 +369,6 @@ public function scopeByEmail(Builder $query, string $email): Builder * Create user ppassword. * * @param string $password user password - * * @return self * * @author Seven Du @@ -384,7 +388,6 @@ public function createPassword(string $password): self * @DateTime 2016-12-30T18:44:40+0800 * * @param string $password [description] - * * @return bool 验证结果true or false */ public function verifyPassword(string $password): bool @@ -397,6 +400,7 @@ public function verifyPassword(string $password): bool * 用户未读数统计. * * @return mixed + * * @author BS <414606094@qq.com> */ public function unreadCount() @@ -408,6 +412,7 @@ public function unreadCount() * 被举报记录. * * @return morphMany + * * @author BS <414606094@qq.com> */ public function reports() diff --git a/app/Models/UserCount.php b/app/Models/UserCount.php index 60cda6d69..093667a57 100644 --- a/app/Models/UserCount.php +++ b/app/Models/UserCount.php @@ -30,6 +30,7 @@ * @property string|null $read_at * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|UserCount newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|UserCount newQuery() * @method static \Illuminate\Database\Eloquent\Builder|UserCount query() diff --git a/app/Models/UserExtra.php b/app/Models/UserExtra.php index 368a602e7..e8ca522fb 100644 --- a/app/Models/UserExtra.php +++ b/app/Models/UserExtra.php @@ -37,6 +37,7 @@ * @property int|null $checkin_count 用户签到统计 * @property int|null $last_checkin_count 用户连续签到统计 * @property-read \Zhiyi\Plus\Models\User $user + * * @method static \Illuminate\Database\Eloquent\Builder|UserExtra newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|UserExtra newQuery() * @method static \Illuminate\Database\Eloquent\Builder|UserExtra query() diff --git a/app/Models/UserFollow.php b/app/Models/UserFollow.php index 4415c189d..39cd266c6 100644 --- a/app/Models/UserFollow.php +++ b/app/Models/UserFollow.php @@ -28,6 +28,7 @@ * @property int $target 目标用户 * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|UserFollow newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|UserFollow newQuery() * @method static \Illuminate\Database\Eloquent\Builder|UserFollow query() diff --git a/app/Models/UserRecommended.php b/app/Models/UserRecommended.php index f627832f6..2c7040e31 100644 --- a/app/Models/UserRecommended.php +++ b/app/Models/UserRecommended.php @@ -30,6 +30,7 @@ * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Zhiyi\Plus\Models\User $user + * * @method static \Illuminate\Database\Eloquent\Builder|UserRecommended newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|UserRecommended newQuery() * @method static \Illuminate\Database\Eloquent\Builder|UserRecommended query() diff --git a/app/Models/UserUnreadCount.php b/app/Models/UserUnreadCount.php index 95e9509ec..8d7cdc994 100644 --- a/app/Models/UserUnreadCount.php +++ b/app/Models/UserUnreadCount.php @@ -30,6 +30,7 @@ * @property int $unread_likes_count 未读点赞数 * @property \Illuminate\Support\Carbon|null $created_at * @property \Illuminate\Support\Carbon|null $updated_at + * * @method static \Illuminate\Database\Eloquent\Builder|UserUnreadCount newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|UserUnreadCount newQuery() * @method static \Illuminate\Database\Eloquent\Builder|UserUnreadCount query() diff --git a/app/Models/VerificationCode.php b/app/Models/VerificationCode.php index d03bdd871..f3de79d82 100644 --- a/app/Models/VerificationCode.php +++ b/app/Models/VerificationCode.php @@ -41,6 +41,7 @@ * @property-read \Illuminate\Notifications\DatabaseNotificationCollection|\Illuminate\Notifications\DatabaseNotification[] $notifications * @property-read int|null $notifications_count * @property-read \Zhiyi\Plus\Models\User|null $user + * * @method static Builder|VerificationCode byValid($second = 300) * @method static Builder|VerificationCode newModelQuery() * @method static Builder|VerificationCode newQuery() @@ -77,6 +78,7 @@ public function routeNotificationFor() * Has User. * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author Seven Du */ public function user() @@ -87,9 +89,8 @@ public function user() /** * 设置复用的创建时间范围查询，单位秒. * - * @param Builder $query 查询对象 - * @param int $second 范围时间，单位秒 - * + * @param Builder $query 查询对象 + * @param int $second 范围时间，单位秒 * @return Builder 查询对象 * * @author Seven Du @@ -107,8 +108,7 @@ public function scopeByValid(Builder $query, int $second = 300): Builder /** * 计算距离验证码过期时间. * - * @param int $vaildSecond 验证的总时间 - * + * @param int $vaildSecond 验证的总时间 * @return int 剩余时间 * * @author Seven Du diff --git a/app/Models/Wallet.php b/app/Models/Wallet.php index d4c68768b..72769dbbd 100644 --- a/app/Models/Wallet.php +++ b/app/Models/Wallet.php @@ -33,6 +33,7 @@ * @property \Illuminate\Support\Carbon|null $updated_at * @property string|null $deleted_at * @property-read \Zhiyi\Plus\Models\User $user + * * @method static \Illuminate\Database\Eloquent\Builder|Wallet newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|Wallet newQuery() * @method static \Illuminate\Database\Eloquent\Builder|Wallet query() @@ -52,6 +53,7 @@ class Wallet extends Model * Get the user of the wallet. * * @return \Illuminate\Database\Eloquent\Relations\BelongsTo + * * @author Seven Du */ public function user(): BelongsTo diff --git a/app/Models/WalletCash.php b/app/Models/WalletCash.php index ff7ca76ed..2d1943197 100644 --- a/app/Models/WalletCash.php +++ b/app/Models/WalletCash.php @@ -39,6 +39,7 @@ * @property \Illuminate\Support\Carbon|null $updated_at * @property \Illuminate\Support\Carbon|null $deleted_at * @property-read \Zhiyi\Plus\Models\User $user + * * @method static \Illuminate\Database\Eloquent\Builder|WalletCash newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|WalletCash newQuery() * @method static \Illuminate\Database\Query\Builder|WalletCash onlyTrashed() @@ -65,6 +66,7 @@ class WalletCash extends Model * User. * * @return \Illuminate\Database\Eloquent\Relations\BelongsTo + * * @author Seven Du */ public function user() diff --git a/app/Models/WalletCharge.php b/app/Models/WalletCharge.php index 77b55939d..2b3a0d0b0 100644 --- a/app/Models/WalletCharge.php +++ b/app/Models/WalletCharge.php @@ -42,6 +42,7 @@ * @property \Illuminate\Support\Carbon|null $updated_at * @property \Illuminate\Support\Carbon|null $deleted_at * @property-read \Zhiyi\Plus\Models\User|null $user + * * @method static \Illuminate\Database\Eloquent\Builder|WalletCharge newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|WalletCharge newQuery() * @method static \Illuminate\Database\Query\Builder|WalletCharge onlyTrashed() @@ -73,6 +74,7 @@ class WalletCharge extends Model * User. * * @return \Illuminate\Database\Eloquent\Relations\BelongsTo + * * @author Seven Du */ public function user() diff --git a/app/Models/WalletOrder.php b/app/Models/WalletOrder.php index 669f87528..150e267df 100644 --- a/app/Models/WalletOrder.php +++ b/app/Models/WalletOrder.php @@ -39,6 +39,7 @@ * @property \Illuminate\Support\Carbon|null $updated_at * @property-read \Zhiyi\Plus\Models\User|null $owner * @property-read \Zhiyi\Plus\Models\NewWallet|null $wallet + * * @method static \Illuminate\Database\Eloquent\Builder|WalletOrder newModelQuery() * @method static \Illuminate\Database\Eloquent\Builder|WalletOrder newQuery() * @method static \Illuminate\Database\Eloquent\Builder|WalletOrder query() @@ -68,6 +69,7 @@ class WalletOrder extends Model * The order owner. * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author Seven Du */ public function owner(): HasOne @@ -79,6 +81,7 @@ public function owner(): HasOne * The order owner wallet. * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author Seven Du */ public function wallet(): HasOne diff --git a/app/Notifications/Channels/SmsChannel.php b/app/Notifications/Channels/SmsChannel.php index d561b5d8c..de48146b6 100644 --- a/app/Notifications/Channels/SmsChannel.php +++ b/app/Notifications/Channels/SmsChannel.php @@ -43,8 +43,9 @@ class SmsChannel /** * Create the SMS notification channel instance. * - * @param \Illuminate\Contracts\Foundation\Application $app - * @param \Overtrue\EasySms\EasySms $sms + * @param \Illuminate\Contracts\Foundation\Application $app + * @param \Overtrue\EasySms\EasySms $sms + * * @author Seven Du */ public function __construct(ApplicationContract $app, EasySms $sms) @@ -59,6 +60,7 @@ public function __construct(ApplicationContract $app, EasySms $sms) * @param mixed $notifiable * @param \Illuminate\Notifications\Notification $notification * @return array|void + * * @throws \Overtrue\EasySms\Exceptions\InvalidArgumentException * @throws \Overtrue\EasySms\Exceptions\NoGatewayAvailableException */ diff --git a/app/Notifications/Comment.php b/app/Notifications/Comment.php index 502205c8c..b210dd5df 100644 --- a/app/Notifications/Comment.php +++ b/app/Notifications/Comment.php @@ -36,8 +36,8 @@ class Comment extends Notification implements ShouldQueue /** * Create a new notification instance. * - * @param CommentModel $comment - * @param UserModel $sender + * @param CommentModel $comment + * @param UserModel $sender */ public function __construct(CommentModel $comment, UserModel $sender) { diff --git a/app/Notifications/Messages/UserNotificationMessage.php b/app/Notifications/Messages/UserNotificationMessage.php index 1c407dc9c..7d524910f 100644 --- a/app/Notifications/Messages/UserNotificationMessage.php +++ b/app/Notifications/Messages/UserNotificationMessage.php @@ -60,10 +60,11 @@ class UserNotificationMessage /** * Create the message instance. * - * @param string $channel - * @param mixed $target - * @param string $content - * @param array $extra + * @param string $channel + * @param mixed $target + * @param string $content + * @param array $extra + * * @author Seven Du */ public function __construct(string $channel, string $content, array $extra = []) @@ -94,6 +95,7 @@ public function getContent(): string * The message to array. * * @return array + * * @author Seven Du */ public function toArray(): array diff --git a/app/Notifications/Messages/VerificationCodeMessage.php b/app/Notifications/Messages/VerificationCodeMessage.php index db7ee4b60..b4cd87023 100644 --- a/app/Notifications/Messages/VerificationCodeMessage.php +++ b/app/Notifications/Messages/VerificationCodeMessage.php @@ -32,8 +32,9 @@ class VerificationCodeMessage extends Message /** * Create the message instance. * - * @param \Illuminate\Config\Repository $config - * @param int $code + * @param \Illuminate\Config\Repository $config + * @param int $code + * * @author Seven Du */ public function __construct(ConfigRepository $config, int $code) @@ -45,8 +46,9 @@ public function __construct(ConfigRepository $config, int $code) /** * Get the message content. * - * @param \Overtrue\EasySms\Contracts\GatewayInterface|null $gateway + * @param \Overtrue\EasySms\Contracts\GatewayInterface|null $gateway * @return string + * * @author Seven Du */ public function getContent(GatewayInterface $gateway = null) @@ -59,8 +61,9 @@ public function getContent(GatewayInterface $gateway = null) /** * Get the message template. * - * @param \Overtrue\EasySms\Contracts\GatewayInterface|null $gateway + * @param \Overtrue\EasySms\Contracts\GatewayInterface|null $gateway * @return string + * * @author Seven Du */ public function getTemplate(GatewayInterface $gateway = null) @@ -73,8 +76,9 @@ public function getTemplate(GatewayInterface $gateway = null) /** * Get the message data. * - * @param \Overtrue\EasySms\Contracts\GatewayInterface|null $gateway + * @param \Overtrue\EasySms\Contracts\GatewayInterface|null $gateway * @return array + * * @author Seven Du */ public function getData(GatewayInterface $gateway = null) @@ -89,8 +93,9 @@ public function getData(GatewayInterface $gateway = null) /** * Get Gateway Alias name. * - * @param \Overtrue\EasySms\Contracts\GatewayInterface $gateway + * @param \Overtrue\EasySms\Contracts\GatewayInterface $gateway * @return string + * * @author Seven Du */ protected function gatewayAliasName(GatewayInterface $gateway = null): string diff --git a/app/Notifications/VerificationCode.php b/app/Notifications/VerificationCode.php index 9c64c6f10..ea3cbe033 100644 --- a/app/Notifications/VerificationCode.php +++ b/app/Notifications/VerificationCode.php @@ -42,7 +42,8 @@ class VerificationCode extends Notification implements ShouldQueue /** * Create the verification notification instance. * - * @param \Zhiyi\Plus\Models\VerificationCode $model + * @param \Zhiyi\Plus\Models\VerificationCode $model + * * @author Seven Du */ public function __construct(VerificationCodeModel $model) @@ -53,7 +54,7 @@ public function __construct(VerificationCodeModel $model) /** * Get the notification's delivery channels. * - * @param \Zhiyi\Plus\Models\VerificationCode $notifiable + * @param \Zhiyi\Plus\Models\VerificationCode $notifiable * @return array */ public function via(VerificationCodeModel $notifiable) @@ -64,7 +65,7 @@ public function via(VerificationCodeModel $notifiable) /** * Get the mail representation of the notification. * - * @param \Zhiyi\Plus\Models\VerificationCode $notifiable + * @param \Zhiyi\Plus\Models\VerificationCode $notifiable * @return \Illuminate\Notifications\Messages\MailMessage */ public function toMail(VerificationCodeModel $notifiable) @@ -78,8 +79,9 @@ public function toMail(VerificationCodeModel $notifiable) /** * Get the SMS representation of the norification. * - * @param \Zhiyi\Plus\Models\VerificationCode $notifiable + * @param \Zhiyi\Plus\Models\VerificationCode $notifiable * @return [type] + * * @author Seven Du */ public function toSms(VerificationCodeModel $notifiable, Config $config) diff --git a/app/Observers/UserObserver.php b/app/Observers/UserObserver.php index f473039b3..704699403 100644 --- a/app/Observers/UserObserver.php +++ b/app/Observers/UserObserver.php @@ -27,7 +27,6 @@ class UserObserver * Handle the user "created" event. * * @param User $user - * * @return void */ public function created(User $user) diff --git a/app/Packages/Currency/Process.php b/app/Packages/Currency/Process.php index 5ad3f0727..ae7416025 100644 --- a/app/Packages/Currency/Process.php +++ b/app/Packages/Currency/Process.php @@ -42,9 +42,10 @@ public function __construct() * * @param $user * @param bool $throw - * * @return UserModel | bool + * * @throws \Exception + * * @author BS <414606094@qq.com> */ public function checkUser($user, $throw = true) @@ -68,8 +69,8 @@ public function checkUser($user, $throw = true) * 检测用户货币模型，防止后续操作出现错误. * * @param UserModel $user - * * @return UserModel + * * @author BS <414606094@qq.com> */ protected function checkCurrency(UserModel $user): UserModel diff --git a/app/Packages/Currency/Processes/AppStorePay.php b/app/Packages/Currency/Processes/AppStorePay.php index fd183f962..becdbd6cd 100644 --- a/app/Packages/Currency/Processes/AppStorePay.php +++ b/app/Packages/Currency/Processes/AppStorePay.php @@ -47,9 +47,10 @@ public function __construct($sandbox = null) /** * 验证票据. * - * @param string $receipt + * @param string $receipt * @param Zhiyi\Plus\Models\CurrencyOrderModel * @return mixed + * * @author BS <414606094@qq.com> */ public function verifyReceipt(string $receipt, CurrencyOrderModel $currencyOrder): bool @@ -98,9 +99,10 @@ protected function sendReceiptToAppStore($body) /** * Create Order. * - * @param int $owner - * @param int $amount + * @param int $owner + * @param int $amount * @return Zhiyi\Plus\Models\CurrencyOrderModel + * * @author BS <414606094@qq.com> */ public function createOrder(int $owner_id, int $amount): CurrencyOrderModel @@ -127,8 +129,9 @@ public function createOrder(int $owner_id, int $amount): CurrencyOrderModel /** * 完成充值操作. * - * @param CurrencyOrderModel $currencyOrderModel + * @param CurrencyOrderModel $currencyOrderModel * @return boolen + * * @author BS <414606094@qq.com> */ private function complete(CurrencyOrderModel $currencyOrderModel): bool @@ -147,8 +150,9 @@ private function complete(CurrencyOrderModel $currencyOrderModel): bool /** * 验证苹果收据与系统内订单是否一致. * - * @param array $data - * @param CurrencyOrderModel $order + * @param array $data + * @param CurrencyOrderModel $order + * * @author BS <414606094@qq.com> */ protected function checkAppleOrder(array $data, CurrencyOrderModel $order) @@ -175,6 +179,7 @@ protected function checkAppleOrder(array $data, CurrencyOrderModel $order) /** * 设置状态错误消息. + * * @param $status */ private function getStatusError($status): string diff --git a/app/Packages/Currency/Processes/Cash.php b/app/Packages/Currency/Processes/Cash.php index 16a1d51fd..bac4fd24b 100644 --- a/app/Packages/Currency/Processes/Cash.php +++ b/app/Packages/Currency/Processes/Cash.php @@ -31,9 +31,10 @@ class Cash extends Process /** * 创建积分提取记录. * - * @param int $owner_id - * @param int $amount + * @param int $owner_id + * @param int $amount * @return Zhiyi\Plus\Models\CurrencyOrder + * * @author BS <414606094@qq.com> */ public function createOrder(int $owner_id, int $amount): CurrencyOrderModel diff --git a/app/Packages/Currency/Processes/Common.php b/app/Packages/Currency/Processes/Common.php index 9c8bf0449..f8840a1bd 100644 --- a/app/Packages/Currency/Processes/Common.php +++ b/app/Packages/Currency/Processes/Common.php @@ -34,9 +34,10 @@ class Common extends Process * @param int $type * @param string $title * @param string $body - * * @return CurrencyOrderModel + * * @throws \Exception + * * @author BS <414606094@qq.com> */ public function createOrder( diff --git a/app/Packages/Currency/Processes/Recharge.php b/app/Packages/Currency/Processes/Recharge.php index cef4535fb..0804c3db6 100644 --- a/app/Packages/Currency/Processes/Recharge.php +++ b/app/Packages/Currency/Processes/Recharge.php @@ -61,8 +61,8 @@ public function createOrder(int $owner_id, int $amount): CurrencyOrderModel * @param int $amount * @param string $type * @param array $extra - * * @return mixed + * * @author BS <414606094@qq.com> */ public function createPingPPOrder(int $owner_id, int $amount, string $type, array $extra = []) @@ -93,6 +93,7 @@ public function createPingPPOrder(int $owner_id, int $amount, string $type, arra * 主动取回凭据. * * @return boolen + * * @author BS <414606094@qq.com> */ public function retrieve(CurrencyOrderModel $currencyOrderModel): bool @@ -110,8 +111,8 @@ public function retrieve(CurrencyOrderModel $currencyOrderModel): bool * 异步回调通知. * * @param Request $request - * * @return boolen + * * @author BS <414606094@qq.com> */ public function webhook(Request $request): bool @@ -136,8 +137,8 @@ public function webhook(Request $request): bool * * @param PingppCharge $pingppCharge * @param CurrencyOrderModel $currencyOrderModel - * * @return boolen + * * @author BS <414606094@qq.com> */ private function complete(CurrencyOrderModel $currencyOrderModel): bool @@ -157,8 +158,8 @@ private function complete(CurrencyOrderModel $currencyOrderModel): bool * 验证回调信息. * * @param Request $request - * * @return boolen + * * @author BS <414606094@qq.com> */ protected function verifyWebHook(Request $request): bool diff --git a/app/Packages/Currency/Processes/User.php b/app/Packages/Currency/Processes/User.php index 456f3d85b..a5c6e398c 100644 --- a/app/Packages/Currency/Processes/User.php +++ b/app/Packages/Currency/Processes/User.php @@ -36,9 +36,10 @@ class User extends Process * @param int $amount * @param int $target_id * @param array $extra - * * @return bool + * * @throws Exception + * * @author BS <414606094@qq.com> */ public function complete($owner, int $amount, $target_id, array $extra): bool @@ -73,9 +74,10 @@ public function complete($owner, int $amount, $target_id, array $extra): bool * @param int $target_id * @param string $title * @param string $body - * * @return bool + * * @throws Exception + * * @author BS <414606094@qq.com> */ public function prepayment($owner, int $amount, int $target_id, string $title, string $body): bool @@ -100,9 +102,10 @@ public function prepayment($owner, int $amount, int $target_id, string $title, s * @param int $target_id * @param string $title * @param string $body - * * @return bool + * * @throws Exception + * * @author BS <414606094@qq.com> */ public function receivables($owner, int $amount, int $target_id, string $title, string $body): bool @@ -127,9 +130,10 @@ public function receivables($owner, int $amount, int $target_id, string $title, * @param int $target_id * @param string $title * @param string $body - * * @return bool + * * @throws Exception + * * @author BS <414606094@qq.com> */ public function reject(int $owner_id, int $amount, int $target_id, string $title, string $body): bool @@ -155,8 +159,8 @@ public function reject(int $owner_id, int $amount, int $target_id, string $title * @param string $title * @param string $body * @param int|int $target_id - * * @return CurrencyOrderModel + * * @author BS <414606094@qq.com> */ public function createOrder(UserModel $user, int $amount, int $type, string $title = '', string $body = '', int $target_id = 0): CurrencyOrderModel @@ -179,8 +183,8 @@ public function createOrder(UserModel $user, int $amount, int $type, string $tit * * @param int $amount * @param array $extra - * * @return array + * * @author BS <414606094@qq.com> */ private function checkDefaultParam(int $amount, array $extra): array diff --git a/app/Packages/Wallet/Order.php b/app/Packages/Wallet/Order.php index 96a6e5a3c..07bb11ede 100644 --- a/app/Packages/Wallet/Order.php +++ b/app/Packages/Wallet/Order.php @@ -56,8 +56,9 @@ class Order /** * Init order or create a order. * - * @param mixed $order - * @param array $args see static::createOrder method + * @param mixed $order + * @param array $args see static::createOrder method + * * @author Seven Du */ public function __construct($order = null) @@ -70,7 +71,8 @@ public function __construct($order = null) /** * Set order model. * - * @param \Zhiyi\Plus\Models\WalletOrder $order + * @param \Zhiyi\Plus\Models\WalletOrder $order + * * @author Seven Du */ public function setOrderModel(WalletOrderModel $order) @@ -84,6 +86,7 @@ public function setOrderModel(WalletOrderModel $order) * Get order model. * * @return \Zhiyi\Plus\Models\WalletOrder + * * @author Seven Du */ public function getOrderModel(): WalletOrderModel @@ -95,6 +98,7 @@ public function getOrderModel(): WalletOrderModel * Has order success. * * @return bool + * * @author Seven Du */ public function hasSuccess(): bool @@ -106,6 +110,7 @@ public function hasSuccess(): bool * Has order fail. * * @return bool + * * @author Seven Du */ public function hasFail(): bool @@ -117,6 +122,7 @@ public function hasFail(): bool * Has order wait. * * @return bool + * * @author Seven Du */ public function hasWait(): bool @@ -128,6 +134,7 @@ public function hasWait(): bool * Save order save method. * * @return mixed + * * @author Seven Du */ public function save() @@ -139,6 +146,7 @@ public function save() * Save and set order [state=1]. * * @return mixed + * * @author Seven Du */ public function saveStateSuccess() @@ -152,6 +160,7 @@ public function saveStateSuccess() * Save and set order [state=-1]. * * @return mixed + * * @author Seven Du */ public function saveStateFial() @@ -165,6 +174,7 @@ public function saveStateFial() * Auth complete. * * @return bool + * * @author Seven Du */ public function autoComplete(...$arguments): bool @@ -183,6 +193,7 @@ public function autoComplete(...$arguments): bool * Get TargetTypeManager instance. * * @return \Zhiyi\Plus\Packages\Wallet\TargetTypeManager + * * @author Seven Du */ public function getTargetTypeManager(): TargetTypeManager diff --git a/app/Packages/Wallet/TargetTypeManager.php b/app/Packages/Wallet/TargetTypeManager.php index 379df710d..742390a5b 100644 --- a/app/Packages/Wallet/TargetTypeManager.php +++ b/app/Packages/Wallet/TargetTypeManager.php @@ -30,7 +30,8 @@ class TargetTypeManager extends Manager /** * Set the manager order. * - * @param \Zhiyi\Plus\Packages\Wallet\Order $order + * @param \Zhiyi\Plus\Packages\Wallet\Order $order + * * @author Seven Du */ public function setOrder(Order $order) @@ -42,6 +43,7 @@ public function setOrder(Order $order) * Get the order target type driver. * * @return string + * * @author Seven Du */ public function getDefaultDriver() @@ -53,6 +55,7 @@ public function getDefaultDriver() * Create user target type driver. * * @return \Zhiyi\Plus\Packages\TargetTypes\Target + * * @author Seven Du */ protected function createUserDriver(): Target @@ -67,6 +70,7 @@ protected function createUserDriver(): Target * Create widthdraw target type driver. * * @return \Zhiyi\Plus\Packages\TargetTypes\Target + * * @author BS <414606094@qq.com> */ protected function createWidthdrawDriver(): Target @@ -81,6 +85,7 @@ protected function createWidthdrawDriver(): Target * Create Rew target type driver. * * @return \Zhiyi\Plus\Packages\TargetTypes\Target + * * @author hh <915664508@qq.com> */ protected function createRewardDriver(): Target @@ -95,6 +100,7 @@ protected function createRewardDriver(): Target * Create Charge target type driver. * * @return \Zhiyi\Plus\Packages\TargetTypes\Target + * * @author BS <414606094@qq.com> */ protected function createRechargePingPPDriver(): Target @@ -109,6 +115,7 @@ protected function createRechargePingPPDriver(): Target * Create Transform target type driver. * * @return \Zhiyi\Plus\Packages\TargetTypes\Target + * * @author BS <414606094@qq.com> */ protected function createTransformDriver(): Target diff --git a/app/Packages/Wallet/TargetTypes/RechargeTarget.php b/app/Packages/Wallet/TargetTypes/RechargeTarget.php index 5b8ab3bc3..cf5eea40f 100644 --- a/app/Packages/Wallet/TargetTypes/RechargeTarget.php +++ b/app/Packages/Wallet/TargetTypes/RechargeTarget.php @@ -38,6 +38,7 @@ class RechargeTarget extends Target * Handle. * * @return mixed + * * @author BS <414606094@qq.com> */ public function handle(): bool @@ -67,6 +68,7 @@ public function handle(): bool * 完成后的通知操作. * * @return void + * * @author BS <414606094@qq.com> */ protected function sendNotification() @@ -78,6 +80,7 @@ protected function sendNotification() * 初始化钱包. * * @return void + * * @author BS <414606094@qq.com> */ protected function initWallet() diff --git a/app/Packages/Wallet/TargetTypes/RewardTarget.php b/app/Packages/Wallet/TargetTypes/RewardTarget.php index 7a1200fb4..ef6839dbe 100644 --- a/app/Packages/Wallet/TargetTypes/RewardTarget.php +++ b/app/Packages/Wallet/TargetTypes/RewardTarget.php @@ -36,6 +36,7 @@ class RewardTarget extends Target * Handle. * * @return mixed + * * @author hh <915664508@qq.com> */ public function handle($extra): bool @@ -84,6 +85,7 @@ public function getTargetOrder() * Send notification. * * @return void + * * @author hh <915664508@qq.com> */ protected function sendNotification($extra) @@ -95,6 +97,7 @@ protected function sendNotification($extra) * Init owner and target user wallet. * * @return void + * * @author hh <915664508@qq.com> */ protected function initWallet() @@ -114,6 +117,7 @@ protected function initWallet() * Create target user order. * * @return void + * * @author hh <915664508@qq.com> */ protected function createTargetRewordOrder(string $body) @@ -135,6 +139,7 @@ protected function createTargetRewordOrder(string $body) * Get target user order type. * * @return int + * * @author hh <915664508@qq.com> */ protected function getTargetRewordOrderType(): int @@ -149,9 +154,10 @@ protected function getTargetRewordOrderType(): int /** * Transfer. * - * @param \Zhiyi\Plus\Packages\Wallet\Order $order - * @param \Zhiyi\Plus\Packages\Wallet\Wallet $wallet + * @param \Zhiyi\Plus\Packages\Wallet\Order $order + * @param \Zhiyi\Plus\Packages\Wallet\Wallet $wallet * @return void + * * @author hh <915664508@qq.com> */ protected function transfer(Order $order, Wallet $wallet) diff --git a/app/Packages/Wallet/TargetTypes/Target.php b/app/Packages/Wallet/TargetTypes/Target.php index 2ad91b1ee..e0db9bff4 100644 --- a/app/Packages/Wallet/TargetTypes/Target.php +++ b/app/Packages/Wallet/TargetTypes/Target.php @@ -34,7 +34,8 @@ abstract class Target /** * Set the order service. * - * @param \Zhiyi\Plus\Packages\Wallet\Order $order + * @param \Zhiyi\Plus\Packages\Wallet\Order $order + * * @author Seven Du */ public function setOrder(Order $order) diff --git a/app/Packages/Wallet/TargetTypes/TransformCurrencyTarget.php b/app/Packages/Wallet/TargetTypes/TransformCurrencyTarget.php index f815e18c2..949af2d4d 100644 --- a/app/Packages/Wallet/TargetTypes/TransformCurrencyTarget.php +++ b/app/Packages/Wallet/TargetTypes/TransformCurrencyTarget.php @@ -66,6 +66,7 @@ public function handle(): bool * 初始化钱包. * * @return void + * * @author BS <414606094@qq.com> */ protected function initWallet() diff --git a/app/Packages/Wallet/TargetTypes/UserTarget.php b/app/Packages/Wallet/TargetTypes/UserTarget.php index 5e7f46816..33ebebb63 100644 --- a/app/Packages/Wallet/TargetTypes/UserTarget.php +++ b/app/Packages/Wallet/TargetTypes/UserTarget.php @@ -36,6 +36,7 @@ class UserTarget extends Target * Handle. * * @return mixed + * * @author Seven Du */ public function handle(): bool @@ -68,6 +69,7 @@ public function handle(): bool * Send notification. * * @return void + * * @author Seven Du */ protected function sendNotification() @@ -79,6 +81,7 @@ protected function sendNotification() * Init owner and target user wallet. * * @return void + * * @author Seven Du */ protected function initWallet() @@ -98,6 +101,7 @@ protected function initWallet() * Create target user order. * * @return void + * * @author Seven Du */ protected function createTargetUserOrder() @@ -118,6 +122,7 @@ protected function createTargetUserOrder() * Get target user order type. * * @return int + * * @author Seven Du */ protected function getTargetUserOrderType(): int @@ -132,9 +137,10 @@ protected function getTargetUserOrderType(): int /** * Transfer. * - * @param \Zhiyi\Plus\Packages\Wallet\Order $order - * @param \Zhiyi\Plus\Packages\Wallet\Wallet $wallet + * @param \Zhiyi\Plus\Packages\Wallet\Order $order + * @param \Zhiyi\Plus\Packages\Wallet\Wallet $wallet * @return void + * * @author Seven Du */ protected function transfer(Order $order, Wallet $wallet) diff --git a/app/Packages/Wallet/TargetTypes/WidthdrawTarget.php b/app/Packages/Wallet/TargetTypes/WidthdrawTarget.php index 04e849805..f209890dc 100644 --- a/app/Packages/Wallet/TargetTypes/WidthdrawTarget.php +++ b/app/Packages/Wallet/TargetTypes/WidthdrawTarget.php @@ -39,6 +39,7 @@ class WidthdrawTarget extends Target * Handle. * * @return mixed + * * @author BS <414606094@qq.com> */ public function handle($type, $account): bool @@ -70,6 +71,7 @@ public function handle($type, $account): bool * 完成后的通知操作. * * @return void + * * @author BS <414606094@qq.com> */ protected function sendNotification() @@ -81,6 +83,7 @@ protected function sendNotification() * 初始化钱包. * * @return void + * * @author BS <414606094@qq.com> */ protected function initWallet() @@ -94,6 +97,7 @@ protected function initWallet() * @param $type * @param $account * @return void + * * @author BS <414606094@qq.com> */ protected function createCash($type, $account) diff --git a/app/Packages/Wallet/TypeManager.php b/app/Packages/Wallet/TypeManager.php index a4c81ea04..094c3eca4 100644 --- a/app/Packages/Wallet/TypeManager.php +++ b/app/Packages/Wallet/TypeManager.php @@ -30,6 +30,7 @@ class TypeManager extends Manager * Get default type driver. * * @return string User type + * * @author Seven Du */ public function getDefaultDriver() @@ -41,6 +42,7 @@ public function getDefaultDriver() * Create user driver. * * @return \Zhiyi\Plus\Packages\Wallet\Types\Type + * * @author Seven Du */ protected function createUserDriver(): Type @@ -52,6 +54,7 @@ protected function createUserDriver(): Type * Create widthdraw driver. * * @return \Zhiyi\Plus\Packages\Wallet\Types\Type + * * @author BS <414606094@qq.com> */ protected function createWidthdrawDriver(): Type @@ -63,6 +66,7 @@ protected function createWidthdrawDriver(): Type * Create reward driver. * * @return \Zhiyi\Plus\Packages\Wallet\Types\Type + * * @author hh <915664508@qq.com> */ protected function createRewardDriver(): Type @@ -74,6 +78,7 @@ protected function createRewardDriver(): Type * Create recharge driver. * * @return \Zhiyi\Plus\Packages\Wallet\Types\Type + * * @author BS <414606094@qq.com> */ protected function createRechargePingPPDriver(): Type @@ -85,6 +90,7 @@ protected function createRechargePingPPDriver(): Type * Create transform driver. * * @return \Zhiyi\Plus\Packages\Wallet\Types\Type + * * @author BS <414606094@qq.com> */ protected function createTransformDriver(): Type diff --git a/app/Packages/Wallet/Types/RechargeType.php b/app/Packages/Wallet/Types/RechargeType.php index b8bbbb51e..e4d86a1be 100644 --- a/app/Packages/Wallet/Types/RechargeType.php +++ b/app/Packages/Wallet/Types/RechargeType.php @@ -36,10 +36,11 @@ class RechargeType extends Type * 创建充值订单. * * @param $owner - * @param int $amount - * @param string $type - * @param array $extra + * @param int $amount + * @param string $type + * @param array $extra * @return mixed + * * @author BS <414606094@qq.com> */ public function create($owner, int $amount, string $type, array $extra = []) @@ -69,6 +70,7 @@ public function create($owner, int $amount, string $type, array $extra = []) * 主动取回凭据. * * @return boolen + * * @author BS <414606094@qq.com> */ public function retrieve(WalletOrderModel $walletOrder): bool @@ -85,8 +87,9 @@ public function retrieve(WalletOrderModel $walletOrder): bool /** * 异步回调通知. * - * @param Request $request + * @param Request $request * @return boolen + * * @author BS <414606094@qq.com> */ public function webhook(Request $request): bool @@ -109,6 +112,7 @@ public function webhook(Request $request): bool * 完成订单. * * @return boolen + * * @author BS <414606094@qq.com> */ public function complete(WalletOrderModel $walletOrder): bool @@ -121,8 +125,9 @@ public function complete(WalletOrderModel $walletOrder): bool /** * Check user. * - * @param int|UserModel $user + * @param int|UserModel $user * @return int + * * @author BS <414606094@qq.com> */ protected function checkUserId($user): int @@ -137,9 +142,10 @@ protected function checkUserId($user): int /** * Create Order. * - * @param int $owner - * @param int $amount + * @param int $owner + * @param int $amount * @return Zhiyi\Plus\Models\WalletOrderModel + * * @author BS <414606094@qq.com> */ protected function createOrder(int $owner, int $amount): Order @@ -160,9 +166,10 @@ protected function createOrder(int $owner, int $amount): Order /** * 解决付款订单来源. * - * @param array $charge - * @param string|null $default + * @param array $charge + * @param string|null $default * @return string|null + * * @author BS <414606094@qq.com> */ protected function resolveChargeAccount($charge, $default = null) @@ -182,8 +189,9 @@ protected function resolveChargeAccount($charge, $default = null) /** * 验证回调信息. * - * @param Request $request + * @param Request $request * @return boolen + * * @author BS <414606094@qq.com> */ protected function verifyWebHook(Request $request): bool diff --git a/app/Packages/Wallet/Types/RewardType.php b/app/Packages/Wallet/Types/RewardType.php index 357cf49c9..17a6e3358 100644 --- a/app/Packages/Wallet/Types/RewardType.php +++ b/app/Packages/Wallet/Types/RewardType.php @@ -30,7 +30,7 @@ class RewardType extends Type /** * @param $owner * @param $target - * @param int $amount + * @param int $amount * @param $extra * @return bool */ @@ -59,6 +59,7 @@ public function reward($data, $type = 'auto') * * @param $user * @return int + * * @author hh <915664508@qq.com> */ public function resolveGetUserId($user): int @@ -73,10 +74,11 @@ public function resolveGetUserId($user): int /** * Create a order. * - * @param int $owner - * @param int $target - * @param int $amount + * @param int $owner + * @param int $target + * @param int $amount * @return \Zhiyi\Plus\Packages\Wallet\Order + * * @author hh <915664508@qq.com> */ public function createOrder(int $owner, int $target, int $amount, string $body): Order @@ -87,10 +89,11 @@ public function createOrder(int $owner, int $target, int $amount, string $body): /** * Create order model. * - * @param int $owner - * @param int $target - * @param int $amount + * @param int $owner + * @param int $target + * @param int $amount * @return \Ziyi\Plus\Models\WalletOrder + * * @author hh <915664508@qq.com> */ public function createOrderModel(int $owner, int $target, int $amount, string $body): WalletOrderModel diff --git a/app/Packages/Wallet/Types/TransformCurrencyType.php b/app/Packages/Wallet/Types/TransformCurrencyType.php index 8dfaf166d..178dccfd8 100644 --- a/app/Packages/Wallet/Types/TransformCurrencyType.php +++ b/app/Packages/Wallet/Types/TransformCurrencyType.php @@ -31,8 +31,9 @@ class TransformCurrencyType extends Type * 钱包兑换积分. * * @param $owner - * @param int $amount + * @param int $amount * @return bool + * * @author BS <414606094@qq.com> */ public function transform($owner, int $amount): bool @@ -46,9 +47,10 @@ public function transform($owner, int $amount): bool /** * Create Order. * - * @param int $owner - * @param int $amount + * @param int $owner + * @param int $amount * @return Zhiyi\Plus\Models\WalletOrderModel + * * @author BS <414606094@qq.com> */ protected function createOrder(int $owner, int $amount): Order @@ -69,8 +71,9 @@ protected function createOrder(int $owner, int $amount): Order /** * Check user. * - * @param int|UserModel $user + * @param int|UserModel $user * @return int + * * @author BS <414606094@qq.com> */ protected function checkUserId($user): int diff --git a/app/Packages/Wallet/Types/UserType.php b/app/Packages/Wallet/Types/UserType.php index 04f31ca29..b0b11244b 100644 --- a/app/Packages/Wallet/Types/UserType.php +++ b/app/Packages/Wallet/Types/UserType.php @@ -30,10 +30,11 @@ class UserType extends Type /** * User to user transfer. * - * @param int|\Zhiyi\Plus\Models\User $owner - * @param int|\Zhiyi\Plus\Models\User $target - * @param int $amount + * @param int|\Zhiyi\Plus\Models\User $owner + * @param int|\Zhiyi\Plus\Models\User $target + * @param int $amount * @return bool + * * @author Seven Du */ public function transfer($owner, $target, int $amount): bool @@ -48,8 +49,9 @@ public function transfer($owner, $target, int $amount): bool /** * Resolve get user id. * - * @param int|\Zhiyi\Plus\Models\User $user + * @param int|\Zhiyi\Plus\Models\User $user * @return int + * * @author Seven Du */ protected function resolveGetUserId($user): int @@ -64,10 +66,11 @@ protected function resolveGetUserId($user): int /** * Create a order. * - * @param int $owner - * @param int $target - * @param int $amount + * @param int $owner + * @param int $target + * @param int $amount * @return \Zhiyi\Plus\Packages\Wallet\Order + * * @author Seven Du */ public function createOrder(int $owner, int $target, int $amount): Order @@ -78,10 +81,11 @@ public function createOrder(int $owner, int $target, int $amount): Order /** * Create order model. * - * @param int $owner - * @param int $target - * @param int $amount + * @param int $owner + * @param int $target + * @param int $amount * @return \Ziyi\Plus\Models\WalletOrder + * * @author Seven Du */ public function createOrderModel(int $owner, int $target, int $amount): WalletOrderModel diff --git a/app/Packages/Wallet/Types/WidthdrawType.php b/app/Packages/Wallet/Types/WidthdrawType.php index eb098b680..2d9670c1d 100644 --- a/app/Packages/Wallet/Types/WidthdrawType.php +++ b/app/Packages/Wallet/Types/WidthdrawType.php @@ -30,11 +30,12 @@ class WidthdrawType extends Type /** * 提现. * - * @param int|UserModel $owner - * @param int $amount - * @param string $type - * @param string $account + * @param int|UserModel $owner + * @param int $amount + * @param string $type + * @param string $account * @return boolen + * * @author BS <414606094@qq.com> */ public function widthdraw($owner, $amount, $type, $account): bool @@ -48,8 +49,9 @@ public function widthdraw($owner, $amount, $type, $account): bool /** * Check user. * - * @param int|UserModel $user + * @param int|UserModel $user * @return int + * * @author BS <414606094@qq.com> */ protected function checkUserId($user): int @@ -64,9 +66,10 @@ protected function checkUserId($user): int /** * Create Order. * - * @param int $owner - * @param int $amount + * @param int $owner + * @param int $amount * @return Zhiyi\Plus\Models\WalletOrderModel + * * @author BS <414606094@qq.com> */ protected function createOrder(int $owner, int $amount): Order diff --git a/app/Packages/Wallet/Wallet.php b/app/Packages/Wallet/Wallet.php index bc2986aed..6aadab5dd 100644 --- a/app/Packages/Wallet/Wallet.php +++ b/app/Packages/Wallet/Wallet.php @@ -45,7 +45,8 @@ class Wallet implements Arrayable, Jsonable, JsonSerializable /** * Create wallet. * - * @param int|\Zhiyi\Plus\Models\User $user + * @param int|\Zhiyi\Plus\Models\User $user + * * @author Seven Du */ public function __construct($user = null) @@ -58,7 +59,8 @@ public function __construct($user = null) /** * Set user. * - * @param int|\Zhiyi\Plus\Models\User $user + * @param int|\Zhiyi\Plus\Models\User $user + * * @author Seven Du */ public function setUser($user) @@ -72,6 +74,7 @@ public function setUser($user) * Get the user wallet model. * * @return \Zhiyi\Plus\Models\NewWallet + * * @author Seven Du */ public function getWalletModel(): WalletModel @@ -86,7 +89,8 @@ public function getWalletModel(): WalletModel /** * Increment the user wallet balance. * - * @param int $amount + * @param int $amount + * * @author Seven Du */ public function increment(int $amount) @@ -103,7 +107,8 @@ public function increment(int $amount) /** * Decrement the user wallet balance. * - * @param int $amount + * @param int $amount + * * @author Seven Du */ public function decrement(int $amount) @@ -120,8 +125,9 @@ public function decrement(int $amount) /** * The user wallet balance enough amount. * - * @param int $amount + * @param int $amount * @return bool + * * @author Seven Du */ public function enough(int $amount): bool @@ -134,9 +140,11 @@ public function enough(int $amount): bool /** * Resolve user. * - * @param int|\Zhiyi\Plus\Models\User $user + * @param int|\Zhiyi\Plus\Models\User $user * @return \Zhiyi\Plus\Models\User + * * @throws \Exception + * * @author Seven Du */ protected function resolveUser($user): UserModel @@ -155,8 +163,9 @@ protected function resolveUser($user): UserModel /** * Resolve the user wallet. * - * @param \Zhiyi\Plus\Models\User $user + * @param \Zhiyi\Plus\Models\User $user * @return \Zhiyi\Plus\Models\User + * * @author Seven Du */ protected function resolveWallet(UserModel $user): UserModel @@ -178,6 +187,7 @@ protected function resolveWallet(UserModel $user): UserModel * Convert the model instance to an array. * * @return array + * * @author Seven Du */ public function toArray() @@ -188,9 +198,11 @@ public function toArray() /** * Convert the model instance to JSON. * - * @param int $options + * @param int $options * @return string + * * @throws \RuntimeException + * * @author Seven Du */ public function toJson($options = 0) @@ -208,6 +220,7 @@ public function toJson($options = 0) * Convert the object into something JSON serializable. * * @return array + * * @author Seven Du */ public function jsonSerialize() @@ -219,6 +232,7 @@ public function jsonSerialize() * Convert the model to its string representation. * * @return string + * * @author Seven Du */ public function __toString() @@ -229,8 +243,9 @@ public function __toString() /** * Find user or fail. * - * @param int $user + * @param int $user * @return \Zhiyi\Plus\Models\User + * * @author Seven Du */ protected function userFindOrFail(int $user): UserModel @@ -241,8 +256,9 @@ protected function userFindOrFail(int $user): UserModel /** * Find wallet. * - * @param int $user + * @param int $user * @return Zhiyi\Plus\Models\NewWallet + * * @author Seven Du */ protected function walletFind(int $user) diff --git a/app/Policies/Feed/Topic.php b/app/Policies/Feed/Topic.php index b699aea4a..ca87f3974 100644 --- a/app/Policies/Feed/Topic.php +++ b/app/Policies/Feed/Topic.php @@ -28,8 +28,8 @@ class Topic /** * Check the topic can be operated by the user. * - * @param \Zhiyi\Plus\Models\User $user - * @param \Zhiyi\Plus\Models\FeedTopic $topic + * @param \Zhiyi\Plus\Models\User $user + * @param \Zhiyi\Plus\Models\FeedTopic $topic * @return bool */ public function update(UserModel $user, FeedTopicModel $topic): bool diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php index a86cddff7..5b5bdc74e 100644 --- a/app/Providers/AppServiceProvider.php +++ b/app/Providers/AppServiceProvider.php @@ -84,6 +84,7 @@ public function register() * 注册验证规则. * * @return void + * * @author Seven Du */ protected function registerValidator() @@ -120,8 +121,8 @@ function ($attribute, string $value, array $parameters) { * * @param string|int $value * @param array $parameters - * * @return bool + * * @author Seven Du */ protected function validateDisplayLength(string $value, array $parameters): bool @@ -138,7 +139,6 @@ protected function validateDisplayLength(string $value, array $parameters): bool * * @param string $value * @param array $parameters - * * @return bool */ protected function validateDisplayWidth(string $value, array $parameters): bool @@ -153,7 +153,6 @@ protected function validateDisplayWidth(string $value, array $parameters): bool * * @param float $number * @param array $parameters - * * @return bool */ private function validateBetween(float $number, array $parameters): bool diff --git a/app/Providers/EloquentServiceProvider.php b/app/Providers/EloquentServiceProvider.php index 7390e374f..c2277ef36 100644 --- a/app/Providers/EloquentServiceProvider.php +++ b/app/Providers/EloquentServiceProvider.php @@ -51,6 +51,7 @@ public function register() * Register model morp map. * * @return void + * * @author Seven Du */ protected function registerMorpMap() @@ -64,9 +65,10 @@ protected function registerMorpMap() /** * Set the morph map for polymorphic relations. * - * @param array|null $map - * @param bool|bool $merge + * @param array|null $map + * @param bool|bool $merge * @return array + * * @author Seven Du */ private function setMorphMap(array $map = null, bool $merge = true) diff --git a/app/Providers/EventServiceProvider.php b/app/Providers/EventServiceProvider.php index d3f4ee0b2..bf1d90156 100644 --- a/app/Providers/EventServiceProvider.php +++ b/app/Providers/EventServiceProvider.php @@ -47,6 +47,7 @@ class EventServiceProvider extends ServiceProvider * Register the provider service. * * @return void + * * @author Seven Du */ public function register() diff --git a/app/Services/Push.php b/app/Services/Push.php index 58ffeb6f3..d9a1593d8 100644 --- a/app/Services/Push.php +++ b/app/Services/Push.php @@ -63,7 +63,8 @@ public function push($alert, $audience, $extras = []) * 推送别名. * * @author bs<414606094@qq.com> - * @param Client $client + * + * @param Client $client * @param $alert * @param $audience * @param $notification @@ -97,7 +98,8 @@ protected function pushAlias(Client $client, $alert, $audience, $notification) * Push all. * * @author bs<414606094@qq.com> - * @param Client $client + * + * @param Client $client * @param $alert * @param $notification * @return array diff --git a/app/Services/UserAbility.php b/app/Services/UserAbility.php index fad5001a6..12a354e35 100644 --- a/app/Services/UserAbility.php +++ b/app/Services/UserAbility.php @@ -31,8 +31,9 @@ class UserAbility implements UserAbilityContract /** * Get all roles or get first role. * - * @param string $role + * @param string $role * @return mixed + * * @author Seven Du */ public function roles(string $role = '') @@ -52,8 +53,9 @@ public function roles(string $role = '') /** * Get all abilities or get first ability. * - * @param string $ability + * @param string $ability * @return mixed + * * @author Seven Du */ public function all(string $ability = '') @@ -77,6 +79,7 @@ public function all(string $ability = '') * Get user instance. * * @return \Zhiyi\Plus\Models\User + * * @author Seven Du */ public function user(): UserModel @@ -87,7 +90,8 @@ public function user(): UserModel /** * Set user model. * - * @param \Zhiyi\Plus\Models\User $user + * @param \Zhiyi\Plus\Models\User $user + * * @author Seven Du */ public function setUser(UserModel $user) diff --git a/app/Services/Wallet/Charge.php b/app/Services/Wallet/Charge.php index a9a6c76c5..35f858fc3 100644 --- a/app/Services/Wallet/Charge.php +++ b/app/Services/Wallet/Charge.php @@ -91,8 +91,8 @@ public function __construct() * query a charge. * * @param string $charge - * * @return array + * * @author Seven Du */ public function query(string $charge) @@ -105,8 +105,8 @@ public function query(string $charge) * * @param \Zhiyi\Plus\Models\WalletCharge $charge * @param array $extra - * * @return array + * * @author Seven Du */ public function create(WalletChargeModel $charge, array $extra = []) @@ -135,8 +135,8 @@ public function create(WalletChargeModel $charge, array $extra = []) * @param WalletOrderModel $order * @param string $type * @param array $extra - * * @return array + * * @author BS <414606094@qq.com> */ public function newCreate( @@ -171,8 +171,8 @@ public function newCreate( * @param string $title * @param string $body * @param array $extra - * * @return array + * * @author BS <414606094@qq.com> */ public function createWithoutModel( @@ -200,8 +200,8 @@ public function createWithoutModel( * Format charge id. * * @param int $chargeId - * * @return string + * * @author Seven Du */ public function formatChargeId(int $chargeId): string @@ -214,8 +214,8 @@ public function formatChargeId(int $chargeId): string * Unformat charge id. * * @param string $chargeId - * * @return int + * * @author Seven Du */ public function unformatChargeId(string $chargeId): int @@ -231,6 +231,7 @@ public function unformatChargeId(string $chargeId): int * Get format prefix. * * @return string + * * @author Seven Du */ public function getPrefix(): string @@ -261,8 +262,8 @@ public function setPrefix(string $prefix) * * @param string $type * @param array $extra - * * @return boolen + * * @author BS <414606094@qq.com> */ public function checkRechargeArgs(string $type, array $extra): bool diff --git a/app/Support/BootstrapAPIsEventer.php b/app/Support/BootstrapAPIsEventer.php index 4b2e824ff..11b17b584 100644 --- a/app/Support/BootstrapAPIsEventer.php +++ b/app/Support/BootstrapAPIsEventer.php @@ -42,7 +42,8 @@ class BootstrapAPIsEventer /** * Create the eventer instance. * - * @param \Illuminate\Contracts\Events\Dispatcher $events + * @param \Illuminate\Contracts\Events\Dispatcher $events + * * @author Seven Du */ public function __construct(EventsDispatcherContract $events) @@ -53,9 +54,10 @@ public function __construct(EventsDispatcherContract $events) /** * Register an event listener with the dispatcher. * - * @param string $version - * @param \Closure $callback + * @param string $version + * @param \Closure $callback * @return mixed + * * @author Seven Du */ public function listen(string $version, Closure $callback) @@ -69,9 +71,10 @@ public function listen(string $version, Closure $callback) /** * Fire an event and call the listeners. * - * @param string $version - * @param array $payload + * @param string $version + * @param array $payload * @return array + * * @author Seven Du */ public function dispatch(string $version, array $payload = []): array diff --git a/app/Support/CdnUrlGenerator.php b/app/Support/CdnUrlGenerator.php index 65a11133f..8b5bedd3c 100644 --- a/app/Support/CdnUrlGenerator.php +++ b/app/Support/CdnUrlGenerator.php @@ -36,6 +36,7 @@ abstract class CdnUrlGenerator implements FileUrlGeneratorContract * Get file data model. * * @return \Zhiyi\Plus\Models\File + * * @author Seven Du */ protected function getFile(): File @@ -46,8 +47,9 @@ protected function getFile(): File /** * Set file data model. * - * @param \Zhiyi\Plus\Models\File $file + * @param \Zhiyi\Plus\Models\File $file * @return CdnUrlGenerator + * * @author Seven Du */ protected function setFile(File $file) diff --git a/app/Support/Configuration.php b/app/Support/Configuration.php index 1b46c0ae2..83ffcacf5 100644 --- a/app/Support/Configuration.php +++ b/app/Support/Configuration.php @@ -35,7 +35,8 @@ class Configuration /** * Create basic information. * - * @param \Illuminate\Contracts\Foundation\Application $app + * @param \Illuminate\Contracts\Foundation\Application $app + * * @author Seven Du */ public function __construct(Application $app) @@ -48,6 +49,7 @@ public function __construct(Application $app) * Get vendor configuration. * * @return \Illuminate\Contracts\Config\Repository + * * @author Seven Du */ public function getConfiguration(): RepositoryContract @@ -66,6 +68,7 @@ public function getConfiguration(): RepositoryContract * Get the configuration into a primary array, and the application scenario may be overridden in the Repository. * * @return array + * * @author Seven Du */ public function getConfigurationBase(): array @@ -78,9 +81,10 @@ public function getConfigurationBase(): array /** * Set configuration save to file. * - * @param array|string $key - * @param mixed $value + * @param array|string $key + * @param mixed $value * @return \Illuminate\Contracts\Config\Repository + * * @author Seven Du */ public function set($key, $value = null): RepositoryContract @@ -97,8 +101,9 @@ public function set($key, $value = null): RepositoryContract /** * Save the custom configuration into the YAML file. * - * @param RepositoryContract $config + * @param RepositoryContract $config * @return void + * * @author Seven Du */ public function save(RepositoryContract $config) @@ -122,10 +127,11 @@ public function save(RepositoryContract $config) /** * Converts a multidimensional array to a basic array of point divisions. * - * @param array $target 目标数组 - * @param string $pre 数组前缀 - * @param array $org 原始数组 + * @param array $target 目标数组 + * @param string $pre 数组前缀 + * @param array $org 原始数组 * @return array + * * @author Seven Du */ public function parse(array $target, string $pre = '', array $org = []): array diff --git a/app/Support/ManageRepository.php b/app/Support/ManageRepository.php index 8e7e79256..6d28b25df 100644 --- a/app/Support/ManageRepository.php +++ b/app/Support/ManageRepository.php @@ -27,10 +27,11 @@ class ManageRepository /** * Push manage url. * - * @param string $name - * @param string $uri - * @param array $option + * @param string $name + * @param string $uri + * @param array $option * @return void + * * @author Seven Du */ public function loadManageFrom(string $name, string $uri, array $option = []) @@ -46,6 +47,7 @@ public function loadManageFrom(string $name, string $uri, array $option = []) * Get the manages for the provider. * * @return array + * * @author Seven Du */ public function getManages(): array diff --git a/app/Support/PackageHandler.php b/app/Support/PackageHandler.php index ecd099b26..e3e85904c 100644 --- a/app/Support/PackageHandler.php +++ b/app/Support/PackageHandler.php @@ -41,6 +41,7 @@ abstract class PackageHandler * Get the handles. * * @return array + * * @author Seven Du */ public static function getHandles() @@ -53,8 +54,8 @@ public static function getHandles() * * @param string $name * @param PackageHandler|string $handler - * * @return void + * * @author Seven Du */ public static function loadHandleFrom(string $name, $handler) @@ -66,8 +67,8 @@ public static function loadHandleFrom(string $name, $handler) * 转换处理方法名称为显示名称. * * @param string $handle - * * @return string + * * @author Seven Du */ public function formatHandleToDisplay(string $handle): string @@ -83,8 +84,8 @@ public function formatHandleToDisplay(string $handle): string * 转换处理方法为类方法名称. * * @param string $handle - * * @return string + * * @author Seven Du */ public function formatHandleToMethod(string $handle): string @@ -100,6 +101,7 @@ public function formatHandleToMethod(string $handle): string * Get the handler methods. * * @return array + * * @author Seven Du */ public function methods(): array @@ -124,8 +126,8 @@ public function methods(): array * * @param \Illuminate\Console\Command $command * @param string $handler - * * @return mixed + * * @author Seven Du */ public function handle($command, $handler) diff --git a/app/Support/PinnedsNotificationEventer.php b/app/Support/PinnedsNotificationEventer.php index 8922940dc..14eb8eb31 100644 --- a/app/Support/PinnedsNotificationEventer.php +++ b/app/Support/PinnedsNotificationEventer.php @@ -40,7 +40,8 @@ class PinnedsNotificationEventer /** * create eventer instance. * - * @param Dispatcher $events + * @param Dispatcher $events + * * @author BS <414606094@qq.com> */ public function __construct(Dispatcher $events) @@ -51,8 +52,9 @@ public function __construct(Dispatcher $events) /** * register a listener. * - * @param Closure $callback [description] + * @param Closure $callback [description] * @return [type] [description] + * * @author BS <414606094@qq.com> */ public function listen(Closure $callback) @@ -64,6 +66,7 @@ public function listen(Closure $callback) * call the listeners. * * @return [type] [description] + * * @author BS <414606094@qq.com> */ public function dispatch() diff --git a/app/Support/Setting.php b/app/Support/Setting.php index a4a6bbb1c..5e42dc102 100644 --- a/app/Support/Setting.php +++ b/app/Support/Setting.php @@ -54,7 +54,6 @@ public function __construct(Model $model, string $namespace) * Create a new setting namespace. * * @param string|null $namespace - * * @return self */ public function new(?string $namespace = null): self @@ -81,7 +80,6 @@ public function query() * * @param string|null $name * @param any $default - * * @return any */ public function get(?string $name = null, $default = null) @@ -113,8 +111,8 @@ function () use ($name, $default) { * * @param array|string $name * @param any $contents - * * @return void + * * @throws \Throwable */ public function set($name, $contents = null): void @@ -151,7 +149,6 @@ public function set($name, $contents = null): void * The static method create a setting namespace. * * @param string $namespace - * * @return self */ public static function create(string $namespace) diff --git a/app/Types/Models.php b/app/Types/Models.php index b52c9f0f6..028ce7001 100644 --- a/app/Types/Models.php +++ b/app/Types/Models.php @@ -24,18 +24,21 @@ class Models { /** * Key by classname const. + * * @var string */ public const KEY_BY_CLASSNAME = 'classname'; /** * Key by class alise const,. + * * @var string */ public const KEY_BY_CLASS_ALIAS = 'class alias'; /** * Types. + * * @var array */ public static $types = [ @@ -51,8 +54,8 @@ class Models /** * Get classname alise or get alias classname. * - * @param string $keyBy - * @param string $key + * @param string $keyBy + * @param string $key * @return string|null */ public function get(string $key = null, ?string $keyBy = self::KEY_BY_CLASSNAME): ?string @@ -65,7 +68,7 @@ public function get(string $key = null, ?string $keyBy = self::KEY_BY_CLASSNAME) /** * Get all types. * - * @param string $keyBy + * @param string $keyBy * @return array */ public function all(?string $keyBy = self::KEY_BY_CLASSNAME): array diff --git a/app/Utils/Markdown.php b/app/Utils/Markdown.php index 569ea1e61..e8d2f4d8c 100644 --- a/app/Utils/Markdown.php +++ b/app/Utils/Markdown.php @@ -41,8 +41,9 @@ class Markdown /** * Create the Markdown util instance. * - * @param \Parsedown $parsedown - * @param \League\HTMLToMarkdown\HtmlConverter $htmlConverter + * @param \Parsedown $parsedown + * @param \League\HTMLToMarkdown\HtmlConverter $htmlConverter + * * @author Seven Du */ public function __construct(Parsedown $parsedown, HtmlConverter $htmlConverter) @@ -54,8 +55,9 @@ public function __construct(Parsedown $parsedown, HtmlConverter $htmlConverter) /** * Markdown to html. * - * @param string $markdown + * @param string $markdown * @return string + * * @author Seven Du */ public function toHtml(string $markdown): string @@ -66,8 +68,9 @@ public function toHtml(string $markdown): string /** * Html to markdown. * - * @param string $html + * @param string $html * @return string + * * @author Seven Du */ public function toMarkdown(string $html): string @@ -78,8 +81,9 @@ public function toMarkdown(string $html): string /** * Get safety markdown string. * - * @param string $markdown + * @param string $markdown * @return string + * * @author Seven Du */ public function safetyMarkdown(string $markdown): string @@ -93,8 +97,9 @@ public function safetyMarkdown(string $markdown): string /** * Get safety html string. * - * @param string $html + * @param string $html * @return string + * * @author Seven Du */ public function safetyHtml(string $html): string @@ -105,8 +110,9 @@ public function safetyHtml(string $html): string /** * Filter html. * - * @param string $html + * @param string $html * @return string + * * @author Seven Du */ public function filterHtml(string $html): string diff --git a/app/Utils/Path.php b/app/Utils/Path.php index 661746d4f..081d0a1b8 100644 --- a/app/Utils/Path.php +++ b/app/Utils/Path.php @@ -27,9 +27,10 @@ class Path /** * relative PATH. * - * @param string $fromPath - * @param string $toPath + * @param string $fromPath + * @param string $toPath * @return string + * * @author Seven Du */ public static function relative(string $fromPath, string $toPath): string diff --git a/app/helpers.php b/app/helpers.php index 34d1a6ca4..1e920d6e2 100644 --- a/app/helpers.php +++ b/app/helpers.php @@ -25,8 +25,7 @@ /** * 验证是否是中国验证码. * - * @param string $number - * + * @param string $number * @return bool */ function validateChinaPhoneNumber(string $number): bool @@ -37,7 +36,7 @@ function validateChinaPhoneNumber(string $number): bool /** * 验证用户名是否合法. * - * @param string $username + * @param string $username * @return bool */ function validateUsername(string $username): bool @@ -48,9 +47,10 @@ function validateUsername(string $username): bool /** * Get user login field. * - * @param string $login - * @param string $default + * @param string $login + * @param string $default * @return string + * * @author Seven Du */ function username(string $login, string $default = 'id'): string @@ -73,8 +73,9 @@ function username(string $login, string $default = 'id'): string /** * Find markdown image IDs. * - * @param string $markdown + * @param string $markdown * @return array + * * @author Seven Du */ function findMarkdownImageIDs(string $markdown): array @@ -90,9 +91,10 @@ function findMarkdownImageIDs(string $markdown): array /** * Filter URLs Return part of a string. * - * @param string $data - * @param int $length + * @param string $data + * @param int $length * @return string + * * @author Seven Du */ function filterUrlStringLength(string $data, int $length = 0): string @@ -135,7 +137,6 @@ function filterUrlStringLength(string $data, int $length = 0): string * @param string $namespace * @param string|null $name * @param null $default - * * @return Support\any|Setting */ function setting(string $namespace, ?string $name = null, $default = null) diff --git a/database/seeders/AbilitySeeder.php b/database/seeders/AbilitySeeder.php index 025e8bcc8..433b58bd6 100644 --- a/database/seeders/AbilitySeeder.php +++ b/database/seeders/AbilitySeeder.php @@ -28,6 +28,7 @@ class AbilitySeeder extends Seeder * Run Abilitys Node Insert Data Method. * * @return void + * * @author Seven Du */ public function run() diff --git a/database/seeders/AreasTableSeeder.php b/database/seeders/AreasTableSeeder.php index 0f49ab0e6..3c23fe7a9 100644 --- a/database/seeders/AreasTableSeeder.php +++ b/database/seeders/AreasTableSeeder.php @@ -51,6 +51,7 @@ public function __construct() * The seeder handler. * * @return void + * * @author Seven Du */ public function run() diff --git a/database/seeders/PackagesSeeder.php b/database/seeders/PackagesSeeder.php index c688e3dcd..91a2c3195 100644 --- a/database/seeders/PackagesSeeder.php +++ b/database/seeders/PackagesSeeder.php @@ -27,6 +27,7 @@ class PackagesSeeder extends Seeder * Run the seeder in packages. * * @return void + * * @author Seven Du */ public function run() diff --git a/database/seeders/RoleSeeder.php b/database/seeders/RoleSeeder.php index 94d459115..58e07fff5 100644 --- a/database/seeders/RoleSeeder.php +++ b/database/seeders/RoleSeeder.php @@ -28,6 +28,7 @@ class RoleSeeder extends Seeder * 开始运行 seeder. * * @return void + * * @author Seven Du */ public function run() diff --git a/database/seeders/UsersTableSeeder.php b/database/seeders/UsersTableSeeder.php index 61c092cd0..3541cefca 100644 --- a/database/seeders/UsersTableSeeder.php +++ b/database/seeders/UsersTableSeeder.php @@ -39,6 +39,7 @@ public function run() * Insert the founder information. * * @return void + * * @author Seven Du */ protected function createFounderUser() diff --git a/packages/slimkit-plus-appversion/src/API/Controllers/ClientVersionController.php b/packages/slimkit-plus-appversion/src/API/Controllers/ClientVersionController.php index c5653d817..58125cffe 100644 --- a/packages/slimkit-plus-appversion/src/API/Controllers/ClientVersionController.php +++ b/packages/slimkit-plus-appversion/src/API/Controllers/ClientVersionController.php @@ -29,8 +29,9 @@ class ClientVersionController * get the list of client versions. * * @author bs<414606094@qq.com> - * @param Illuminate\Http\Request $request - * @param ClientVersion $versionModel + * + * @param Illuminate\Http\Request $request + * @param ClientVersion $versionModel * @return mixed */ public function index(Request $request, ClientVersion $versionModel) diff --git a/packages/slimkit-plus-appversion/src/Admin/Controllers/HomeController.php b/packages/slimkit-plus-appversion/src/Admin/Controllers/HomeController.php index 21ffd504b..6817926f3 100644 --- a/packages/slimkit-plus-appversion/src/Admin/Controllers/HomeController.php +++ b/packages/slimkit-plus-appversion/src/Admin/Controllers/HomeController.php @@ -67,10 +67,11 @@ public function storage(ApkUpload $request, ResponseContract $response, Carbon $ /** * Validate and return the file database model instance. * - * @param \Zhiyi\Plus\Models\File $fileModel - * @param \Illuminate\Http\UploadedFile $file - * @param callable $call + * @param \Zhiyi\Plus\Models\File $fileModel + * @param \Illuminate\Http\UploadedFile $file + * @param callable $call * @return \Zhiyi\Plus\Models\File + * * @author Seven Du */ protected function validateFileInDatabase(FileModel $fileModel, UploadedFile $file, callable $call): FileModel @@ -85,10 +86,11 @@ protected function validateFileInDatabase(FileModel $fileModel, UploadedFile $fi /** * 解决数据模型非实例. * - * @param \Zhiyi\Plus\Models\FileWith $fileWith - * @param \Zhiyi\Plus\Models\User $user - * @param \Zhiyi\Plus\Models\File $file + * @param \Zhiyi\Plus\Models\FileWith $fileWith + * @param \Zhiyi\Plus\Models\User $user + * @param \Zhiyi\Plus\Models\File $file * @return \Zhiyi\Plus\Models\FileWith + * * @author Seven Du */ protected function resolveFileWith(FileWithModel $fileWith, UserModel $user, FileModel $file): FileWithModel @@ -130,8 +132,9 @@ public function currentVersion(ClientVersion $clientVersionModel) * get the list of client versions. * * @author bs<414606094@qq.com> - * @param Illuminate\Http\Request $request - * @param ClientVersion $versionModel + * + * @param Illuminate\Http\Request $request + * @param ClientVersion $versionModel * @return mixed */ public function index(Request $request, ClientVersion $clientVersionModel) @@ -153,8 +156,9 @@ public function index(Request $request, ClientVersion $clientVersionModel) * create client version. * * @author bs<414606094@qq.com> - * @param StoreClientVersion $request - * @param ClientVersion $clientVersionModel + * + * @param StoreClientVersion $request + * @param ClientVersion $clientVersionModel * @return mixed */ public function store(StoreClientVersion $request, ClientVersion $clientVersionModel, FileWithModel $fileWith) @@ -183,7 +187,8 @@ public function store(StoreClientVersion $request, ClientVersion $clientVersionM * delete a client version. * * @author bs<414606094@qq.com> - * @param ClientVersion $clientVersion + * + * @param ClientVersion $clientVersion * @return mixed */ public function delete(ClientVersion $clientVersion) @@ -195,7 +200,8 @@ public function delete(ClientVersion $clientVersion) /** * 扩展开启/关闭状态 - * @param Request $request [description] + * + * @param Request $request [description] * @return [type] [description] */ public function status() @@ -207,7 +213,8 @@ public function status() /** * 更新扩展开关状态 - * @param Request $request [description] + * + * @param Request $request [description] * @return [type] [description] */ public function update(Request $request, Configuration $configuration) diff --git a/packages/slimkit-plus-appversion/src/Admin/Requests/ApkUpload.php b/packages/slimkit-plus-appversion/src/Admin/Requests/ApkUpload.php index 28c595b8f..7ec527038 100644 --- a/packages/slimkit-plus-appversion/src/Admin/Requests/ApkUpload.php +++ b/packages/slimkit-plus-appversion/src/Admin/Requests/ApkUpload.php @@ -50,6 +50,7 @@ public function rules() * Get the validation message that apply to the request. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/packages/slimkit-plus-appversion/src/Admin/Requests/StoreClientVersion.php b/packages/slimkit-plus-appversion/src/Admin/Requests/StoreClientVersion.php index 5da12d9a4..e88635db4 100644 --- a/packages/slimkit-plus-appversion/src/Admin/Requests/StoreClientVersion.php +++ b/packages/slimkit-plus-appversion/src/Admin/Requests/StoreClientVersion.php @@ -29,6 +29,7 @@ class StoreClientVersion extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -40,6 +41,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/packages/slimkit-plus-appversion/src/Handlers/DevPackageHandler.php b/packages/slimkit-plus-appversion/src/Handlers/DevPackageHandler.php index 10046755d..fbdbf90c6 100644 --- a/packages/slimkit-plus-appversion/src/Handlers/DevPackageHandler.php +++ b/packages/slimkit-plus-appversion/src/Handlers/DevPackageHandler.php @@ -48,7 +48,6 @@ public function __construct(ApplicationContract $app) * Create a migration file. * * @param \Illuminate\Console\Command $command - * * @return mixed */ public function makeMigrationHandle(Command $command) @@ -89,8 +88,8 @@ public function makeMigrationHandle(Command $command) * Create a database seeder. * * @param \Illuminate\Console\Command $command - * * @return mixed + * * @author Seven Du */ public function makeSeederHandle(Command $command) @@ -129,8 +128,8 @@ public function makeSeederHandle(Command $command) * Make package model. * * @param \Illuminate\Console\Command $command - * * @return mixed + * * @author Seven Du */ public function makeModelHandle(Command $command) diff --git a/packages/slimkit-plus-appversion/src/Providers/AppServiceProvider.php b/packages/slimkit-plus-appversion/src/Providers/AppServiceProvider.php index 5e8750b2d..00a6f4096 100644 --- a/packages/slimkit-plus-appversion/src/Providers/AppServiceProvider.php +++ b/packages/slimkit-plus-appversion/src/Providers/AppServiceProvider.php @@ -126,8 +126,8 @@ protected function registerPackageHandlers() /** * Register handler. * - * @param string $name - * @param \Zhiyi\Plus\Support\PackageHandler|string $handler + * @param string $name + * @param \Zhiyi\Plus\Support\PackageHandler|string $handler * @return void */ private function loadHandleFrom(string $name, $handler) diff --git a/packages/slimkit-plus-appversion/src/Providers/ModelServiceProvider.php b/packages/slimkit-plus-appversion/src/Providers/ModelServiceProvider.php index 732be94b2..bd65f866c 100644 --- a/packages/slimkit-plus-appversion/src/Providers/ModelServiceProvider.php +++ b/packages/slimkit-plus-appversion/src/Providers/ModelServiceProvider.php @@ -67,8 +67,8 @@ protected function registerMorphMap() /** * Set or get the morph map for polymorphic relations. * - * @param array|null $map - * @param bool $merge + * @param array|null $map + * @param bool $merge * @return array */ protected function morphMap(array $map = null, bool $merge = true): array diff --git a/packages/slimkit-plus-appversion/src/Support/Path.php b/packages/slimkit-plus-appversion/src/Support/Path.php index 20b79bf77..6fffb4866 100644 --- a/packages/slimkit-plus-appversion/src/Support/Path.php +++ b/packages/slimkit-plus-appversion/src/Support/Path.php @@ -25,8 +25,8 @@ class Path /** * relative PATH. * - * @param string $fromPath - * @param strong $toPath + * @param string $fromPath + * @param strong $toPath * @return string */ public static function relative(string $fromPath, string $toPath): string diff --git a/packages/slimkit-plus-around-amap/src/Admin/Requests/Request.php b/packages/slimkit-plus-around-amap/src/Admin/Requests/Request.php index 7192bdec6..3e1d9cf39 100644 --- a/packages/slimkit-plus-around-amap/src/Admin/Requests/Request.php +++ b/packages/slimkit-plus-around-amap/src/Admin/Requests/Request.php @@ -28,6 +28,7 @@ class Request extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool diff --git a/packages/slimkit-plus-around-amap/src/Admin/Requests/StoreAmapRequest.php b/packages/slimkit-plus-around-amap/src/Admin/Requests/StoreAmapRequest.php index 517692b38..45fdc8e23 100644 --- a/packages/slimkit-plus-around-amap/src/Admin/Requests/StoreAmapRequest.php +++ b/packages/slimkit-plus-around-amap/src/Admin/Requests/StoreAmapRequest.php @@ -26,6 +26,7 @@ class StoreAmapRequest extends Request * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array @@ -41,6 +42,7 @@ public function rules(): array * Get custom messages for validator errors. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/packages/slimkit-plus-around-amap/src/Providers/ModelServiceProvider.php b/packages/slimkit-plus-around-amap/src/Providers/ModelServiceProvider.php index cf63eea2c..ccec8d6b8 100755 --- a/packages/slimkit-plus-around-amap/src/Providers/ModelServiceProvider.php +++ b/packages/slimkit-plus-around-amap/src/Providers/ModelServiceProvider.php @@ -67,8 +67,8 @@ protected function registerMorphMap() /** * Set or get the morph map for polymorphic relations. * - * @param array|null $map - * @param bool $merge + * @param array|null $map + * @param bool $merge * @return array */ protected function morphMap(array $map = null, bool $merge = true): array diff --git a/packages/slimkit-plus-checkin/database/seeds/AbilitySeeder.php b/packages/slimkit-plus-checkin/database/seeds/AbilitySeeder.php index 9bf47136e..1bfb68b0e 100644 --- a/packages/slimkit-plus-checkin/database/seeds/AbilitySeeder.php +++ b/packages/slimkit-plus-checkin/database/seeds/AbilitySeeder.php @@ -30,6 +30,7 @@ class AbilitySeeder extends Seeder * Run Abilitys Node Insert Data Method. * * @return void + * * @author Seven Du */ public function run() diff --git a/packages/slimkit-plus-checkin/database/seeds/DatabaseSeeder.php b/packages/slimkit-plus-checkin/database/seeds/DatabaseSeeder.php index 8aa255387..8536522c5 100644 --- a/packages/slimkit-plus-checkin/database/seeds/DatabaseSeeder.php +++ b/packages/slimkit-plus-checkin/database/seeds/DatabaseSeeder.php @@ -28,6 +28,7 @@ class DatabaseSeeder extends Seeder * Run the database seeds. * * @return void + * * @author Seven Du */ public function run() diff --git a/packages/slimkit-plus-checkin/database/seeds/SettingsTableSeeder.php b/packages/slimkit-plus-checkin/database/seeds/SettingsTableSeeder.php index 7c2d707e5..e353d7333 100644 --- a/packages/slimkit-plus-checkin/database/seeds/SettingsTableSeeder.php +++ b/packages/slimkit-plus-checkin/database/seeds/SettingsTableSeeder.php @@ -29,6 +29,7 @@ class SettingsTableSeeder extends Seeder * Run the package seeder. * * @return void + * * @author Seven Du */ public function run() diff --git a/packages/slimkit-plus-checkin/src/API/Controllers/CheckInController.php b/packages/slimkit-plus-checkin/src/API/Controllers/CheckInController.php index 0b137f578..13a562789 100644 --- a/packages/slimkit-plus-checkin/src/API/Controllers/CheckInController.php +++ b/packages/slimkit-plus-checkin/src/API/Controllers/CheckInController.php @@ -57,8 +57,8 @@ public function __construct() * @param Request $request * @param ResponseFactoryContract $response * @param CheckinLogModel $model - * * @return mixed + * * @author Seven Du */ public function show( @@ -96,8 +96,8 @@ public function show( * @param Request $request * @param ResponseFactoryContract $response * @param GateContract $gate - * * @return mixed + * * @author Seven Du */ public function store( @@ -166,9 +166,10 @@ public function store( * @param Request $request * @param ResponseFactoryContract $response * @param GateContract $gate - * * @return mixed + * * @throws Exception + * * @author BS <414606094@qq.com> */ public function newStore( diff --git a/packages/slimkit-plus-checkin/src/API/Controllers/RanksController.php b/packages/slimkit-plus-checkin/src/API/Controllers/RanksController.php index 44a99e338..dc52214bc 100644 --- a/packages/slimkit-plus-checkin/src/API/Controllers/RanksController.php +++ b/packages/slimkit-plus-checkin/src/API/Controllers/RanksController.php @@ -31,10 +31,11 @@ class RanksController extends Controller /** * Get all users check-in ranks. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\UserExtra $model + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\UserExtra $model * @return mixed + * * @author Seven Du */ public function index(Request $request, ResponseFactoryContract $response, UserExtraModel $model) diff --git a/packages/slimkit-plus-checkin/src/API/Middleware/CheckInSwitch.php b/packages/slimkit-plus-checkin/src/API/Middleware/CheckInSwitch.php index 8d5860f27..30f82a75d 100644 --- a/packages/slimkit-plus-checkin/src/API/Middleware/CheckInSwitch.php +++ b/packages/slimkit-plus-checkin/src/API/Middleware/CheckInSwitch.php @@ -29,9 +29,10 @@ class CheckInSwitch /** * The middleware handle. * - * @param mixed $request - * @param \Closure $next + * @param mixed $request + * @param \Closure $next * @return mixed + * * @author Seven Du */ public function handle($request, Closure $next) diff --git a/packages/slimkit-plus-checkin/src/Admin/Controllers/HomeController.php b/packages/slimkit-plus-checkin/src/Admin/Controllers/HomeController.php index 45c18b381..47412f948 100644 --- a/packages/slimkit-plus-checkin/src/Admin/Controllers/HomeController.php +++ b/packages/slimkit-plus-checkin/src/Admin/Controllers/HomeController.php @@ -29,6 +29,7 @@ class HomeController * 签到后台入口. * * @return mixed + * * @author Seven Du */ public function index() @@ -42,8 +43,9 @@ public function index() /** * Store checkin config. * - * @param \SlimKit\PlusCheckIn\Admin\Requests\StoreConfig $request + * @param \SlimKit\PlusCheckIn\Admin\Requests\StoreConfig $request * @return mixed + * * @author Seven Du */ public function store(StoreConfigRequest $request) diff --git a/packages/slimkit-plus-checkin/src/Admin/Requests/StoreConfig.php b/packages/slimkit-plus-checkin/src/Admin/Requests/StoreConfig.php index 61689b9a6..5e87fbc88 100644 --- a/packages/slimkit-plus-checkin/src/Admin/Requests/StoreConfig.php +++ b/packages/slimkit-plus-checkin/src/Admin/Requests/StoreConfig.php @@ -28,6 +28,7 @@ class StoreConfig extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array @@ -53,6 +55,7 @@ public function rules(): array * Get custom attributes for validator errors. * * @return array + * * @author Seven Du */ public function attributes(): array diff --git a/packages/slimkit-plus-checkin/src/Policies/CheckInPolicy.php b/packages/slimkit-plus-checkin/src/Policies/CheckInPolicy.php index af8f5a24f..5ae16af2b 100644 --- a/packages/slimkit-plus-checkin/src/Policies/CheckInPolicy.php +++ b/packages/slimkit-plus-checkin/src/Policies/CheckInPolicy.php @@ -30,8 +30,8 @@ class CheckInPolicy * 检查用户是否可以创建签到记录. * * @param User $user - * * @return bool + * * @author Seven Du */ public function create(User $user): bool diff --git a/packages/slimkit-plus-checkin/src/Providers/ModelServiceProvider.php b/packages/slimkit-plus-checkin/src/Providers/ModelServiceProvider.php index 67be856e5..c6b8e6b47 100644 --- a/packages/slimkit-plus-checkin/src/Providers/ModelServiceProvider.php +++ b/packages/slimkit-plus-checkin/src/Providers/ModelServiceProvider.php @@ -68,8 +68,8 @@ protected function registerMorphMap() /** * Set or get the morph map for polymorphic relations. * - * @param array|null $map - * @param bool $merge + * @param array|null $map + * @param bool $merge * @return array */ protected function morphMap(array $map = null, bool $merge = true): array diff --git a/packages/slimkit-plus-checkin/tests/Feature/API2/CheckinRanksTest.php b/packages/slimkit-plus-checkin/tests/Feature/API2/CheckinRanksTest.php index 50736a071..2ae8bb778 100644 --- a/packages/slimkit-plus-checkin/tests/Feature/API2/CheckinRanksTest.php +++ b/packages/slimkit-plus-checkin/tests/Feature/API2/CheckinRanksTest.php @@ -31,6 +31,7 @@ class CheckinRanksTest extends TestCase * Test get checkin ranks. * * @return void + * * @author Seven Du */ public function testGetRanks() diff --git a/packages/slimkit-plus-checkin/tests/Feature/API2/CheckinTest.php b/packages/slimkit-plus-checkin/tests/Feature/API2/CheckinTest.php index fba6040e3..8f0790dd9 100644 --- a/packages/slimkit-plus-checkin/tests/Feature/API2/CheckinTest.php +++ b/packages/slimkit-plus-checkin/tests/Feature/API2/CheckinTest.php @@ -32,6 +32,7 @@ class CheckinTest extends TestCase * Test get checkin ranks. * * @return void + * * @author Seven Du */ public function testCheckin() diff --git a/packages/slimkit-plus-checkin/tests/Feature/API2/UserCheckinTest.php b/packages/slimkit-plus-checkin/tests/Feature/API2/UserCheckinTest.php index 3d0fbed71..e187f4c75 100644 --- a/packages/slimkit-plus-checkin/tests/Feature/API2/UserCheckinTest.php +++ b/packages/slimkit-plus-checkin/tests/Feature/API2/UserCheckinTest.php @@ -32,6 +32,7 @@ class UserCheckinTest extends TestCase * Test Not login request. * * @return void + * * @author Seven Du */ public function testNotLoginRequest() @@ -45,6 +46,7 @@ public function testNotLoginRequest() * Test get user checkin data. * * @return void + * * @author Seven Du */ public function testGetUserCheckin() diff --git a/packages/slimkit-plus-feed/database/seeds/AbilityTableSeeder.php b/packages/slimkit-plus-feed/database/seeds/AbilityTableSeeder.php index 2fa3bf372..9cb601791 100755 --- a/packages/slimkit-plus-feed/database/seeds/AbilityTableSeeder.php +++ b/packages/slimkit-plus-feed/database/seeds/AbilityTableSeeder.php @@ -30,6 +30,7 @@ class AbilityTableSeeder extends Seeder * Run the seeder. * * @return void + * * @author Seven Du */ public function run() diff --git a/packages/slimkit-plus-feed/database/seeds/DatabaseSeeder.php b/packages/slimkit-plus-feed/database/seeds/DatabaseSeeder.php index 2ae7087e1..5ac3d7268 100644 --- a/packages/slimkit-plus-feed/database/seeds/DatabaseSeeder.php +++ b/packages/slimkit-plus-feed/database/seeds/DatabaseSeeder.php @@ -28,6 +28,7 @@ class DatabaseSeeder extends Seeder * Run the package seeder. * * @return void + * * @author Seven Du */ public function run() diff --git a/packages/slimkit-plus-feed/database/seeds/SettingTableSeeder.php b/packages/slimkit-plus-feed/database/seeds/SettingTableSeeder.php index b6007e1a4..28d7f86f4 100644 --- a/packages/slimkit-plus-feed/database/seeds/SettingTableSeeder.php +++ b/packages/slimkit-plus-feed/database/seeds/SettingTableSeeder.php @@ -29,6 +29,7 @@ class SettingTableSeeder extends Seeder * Run the package seeder. * * @return void + * * @author Seven Du */ public function run() diff --git a/packages/slimkit-plus-feed/src/API2/AverageController.php b/packages/slimkit-plus-feed/src/API2/AverageController.php index 623bb7f65..19dac93e4 100644 --- a/packages/slimkit-plus-feed/src/API2/AverageController.php +++ b/packages/slimkit-plus-feed/src/API2/AverageController.php @@ -28,10 +28,10 @@ class AverageController extends Controller { /** - * @param Request $request - * @param Carbon $date - * @param FeedPinned $pinned - * @param ResponseContract $response + * @param Request $request + * @param Carbon $date + * @param FeedPinned $pinned + * @param ResponseContract $response * @return object */ public function show(Carbon $date, FeedPinned $pinned, ResponseContract $response) diff --git a/packages/slimkit-plus-feed/src/API2/CommentPinnedController.php b/packages/slimkit-plus-feed/src/API2/CommentPinnedController.php index bee58eb5c..309460d5e 100755 --- a/packages/slimkit-plus-feed/src/API2/CommentPinnedController.php +++ b/packages/slimkit-plus-feed/src/API2/CommentPinnedController.php @@ -37,9 +37,10 @@ class CommentPinnedController extends Controller /** * 获取动态评论当前用户审核列表. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $model + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $model * @return mixed + * * @author Seven Du */ public function index(Request $request, FeedPinnedModel $model, FeedRepository $repository) @@ -100,14 +101,15 @@ public function index(Request $request, FeedPinnedModel $model, FeedRepository $ /** * 固定评论. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Carbon\Carbon $dateTime - * @param \Zhiyi\Plus\Models\WalletCharge $charge - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed - * @param \Zhiyi\Plus\Models\Comment $comment - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Carbon\Carbon $dateTime + * @param \Zhiyi\Plus\Models\WalletCharge $charge + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Zhiyi\Plus\Models\Comment $comment + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned * @return mixed + * * @author Seven Du */ public function pass( @@ -213,12 +215,13 @@ public function reject( /** * 取消置顶. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Carbon\Carbon $dateTime - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed - * @param \Zhiyi\Plus\Models\Comment $comment + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Carbon\Carbon $dateTime + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Zhiyi\Plus\Models\Comment $comment * @return mixed + * * @author Seven Du */ public function delete( diff --git a/packages/slimkit-plus-feed/src/API2/FeedCollectionController.php b/packages/slimkit-plus-feed/src/API2/FeedCollectionController.php index 82df5c2e9..1bf43916b 100755 --- a/packages/slimkit-plus-feed/src/API2/FeedCollectionController.php +++ b/packages/slimkit-plus-feed/src/API2/FeedCollectionController.php @@ -31,10 +31,11 @@ class FeedCollectionController extends Controller /** * 收藏动态. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return mixed + * * @author Seven Du */ public function store(Request $request, ResponseContract $response, FeedModel $feed) @@ -53,10 +54,11 @@ public function store(Request $request, ResponseContract $response, FeedModel $f /** * 取消收藏. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return mixed + * * @author Seven Du */ public function destroy(Request $request, ResponseContract $response, FeedModel $feed) diff --git a/packages/slimkit-plus-feed/src/API2/FeedCommentController.php b/packages/slimkit-plus-feed/src/API2/FeedCommentController.php index 782f0f626..4844ff50b 100644 --- a/packages/slimkit-plus-feed/src/API2/FeedCommentController.php +++ b/packages/slimkit-plus-feed/src/API2/FeedCommentController.php @@ -45,8 +45,8 @@ class FeedCommentController extends Controller * @param Request $request * @param ResponseFactoryContract $response * @param FeedModel $feed - * * @return mixed + * * @author Seven Du */ public function index( @@ -92,8 +92,8 @@ public function pinneds(Request $request, FeedModel $feed) * @param ResponseFactoryContract $response * @param mixed $feed * @param CommentModel $comment - * * @return mixed + * * @author Seven Du */ public function show( @@ -113,9 +113,10 @@ public function show( * @param ResponseFactoryContract $response * @param FeedModel $feed * @param CommentModel $comment - * * @return mixed + * * @throws \Throwable + * * @author Seven Du */ public function destroy( @@ -171,9 +172,10 @@ public function destroy( * @param ResponseFactoryContract $response * @param FeedModel $feed * @param CommentModel $comment - * * @return mixed + * * @throws \Throwable + * * @author Seven Du */ public function store( diff --git a/packages/slimkit-plus-feed/src/API2/FeedController.php b/packages/slimkit-plus-feed/src/API2/FeedController.php index deff319fd..2a5d4e0b7 100644 --- a/packages/slimkit-plus-feed/src/API2/FeedController.php +++ b/packages/slimkit-plus-feed/src/API2/FeedController.php @@ -60,6 +60,7 @@ class FeedController extends Controller * @param \Illuminate\Http\Request $request * @param \Illuminate\Contracts\Foundation\Application $app * @return mixed + * * @author Seven Du */ public function index( @@ -155,6 +156,7 @@ function (Builder $query) use ($user) { * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feedModel * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Repository\Feed $repository * @return mixed + * * @author Seven Du */ public function new( @@ -242,6 +244,7 @@ function (Builder $query) use ($after) { * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Repository\Feed $repository * @param \Carbon\Carbon $dateTime * @return mixed + * * @author Seven Du */ public function hot( @@ -308,6 +311,7 @@ public function hot( * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Repository\Feed $repository * @param Carbon $datetime * @return mixed + * * @author Seven Du */ public function follow( @@ -383,7 +387,9 @@ public function follow( * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Repository\Feed $repository * @param int $feed * @return mixed + * * @throws Throwable + * * @author Seven Du */ public function show( @@ -572,6 +578,7 @@ public function store(StoreFeedPostRequest $request) * * @param StoreFeedPostRequest $request * @return mixed + * * @author Seven Du */ protected function makeFileWith(StoreFeedPostRequest $request) @@ -595,6 +602,7 @@ protected function makeFileWith(StoreFeedPostRequest $request) * @Author Wayne * @DateTime 2018-04-02 * @Email qiaobin@zhiyicx.com + * * @param StoreFeedPostRequest $request * @return \Illuminate\Database\Eloquent\Builder|\Illuminate\Database\Eloquent\Model|object|null */ @@ -619,6 +627,7 @@ protected function makeVideoWith(StoreFeedPostRequest $request) * @Author Wayne * @DateTime 2018-04-02 * @Email qiaobin@zhiyicx.com + * * @param StoreFeedPostRequest $request * @return \Illuminate\Database\Eloquent\Builder|\Illuminate\Database\Eloquent\Model|object|null */ @@ -642,6 +651,7 @@ protected function makeVideoCoverWith(StoreFeedPostRequest $request) * * @param StoreFeedPostRequest $request * @return mixed + * * @author Seven Du */ protected function makePaidNode(StoreFeedPostRequest $request) @@ -666,10 +676,12 @@ protected function makePaidNode(StoreFeedPostRequest $request) * @Author Wayne * @DateTime 2018-04-02 * @Email qiaobin@zhiyicx.com + * * @param $videoWith * @param $videoCoverWith * @param FeedModel $feed * @return void + * * @throws \Throwable */ protected function saveFeedVideoWith( @@ -707,6 +719,7 @@ protected function saveFeedVideoWith( * @param array $fileWiths * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return void + * * @author Seven Du */ protected function saveFeedFileWith($fileWiths, FeedModel $feed) @@ -724,6 +737,7 @@ protected function saveFeedFileWith($fileWiths, FeedModel $feed) * @param array $nodes * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return void + * * @author Seven Du */ protected function saveFeedFilePaidNode($nodes, FeedModel $feed) @@ -742,6 +756,7 @@ protected function saveFeedFilePaidNode($nodes, FeedModel $feed) * @param \Illuminate\Http\Request $request * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return void + * * @author Seven Du */ protected function saveFeedPaidNode(Request $request, FeedModel $feed) @@ -768,6 +783,7 @@ protected function saveFeedPaidNode(Request $request, FeedModel $feed) * @param \Illuminate\Http\Request $request * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed + * * @author Seven Du */ protected function fillFeedBaseData(Request $request, FeedModel $feed): FeedModel @@ -794,7 +810,9 @@ protected function fillFeedBaseData(Request $request, FeedModel $feed): FeedMode * @param ResponseContract $response * @param FeedModel $feed * @return mixed + * * @throws Throwable + * * @author BS <414606094@qq.com> */ public function newDestroy( @@ -877,6 +895,7 @@ public function newDestroy( * @param FeedModel $feedModel * @param FeedRepository $repository * @return mixed + * * @author bs<414606094@qq.com> */ public function users( diff --git a/packages/slimkit-plus-feed/src/API2/FeedPayController.php b/packages/slimkit-plus-feed/src/API2/FeedPayController.php index c93558413..6b67a3181 100755 --- a/packages/slimkit-plus-feed/src/API2/FeedPayController.php +++ b/packages/slimkit-plus-feed/src/API2/FeedPayController.php @@ -32,11 +32,12 @@ class FeedPayController extends Controller /** * Set feed comment pay. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\PaidNode $paidNode - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\PaidNode $paidNode + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return mixed + * * @author Seven Du */ public function commentPaid( diff --git a/packages/slimkit-plus-feed/src/API2/LikeController.php b/packages/slimkit-plus-feed/src/API2/LikeController.php index f3ff59b03..0cb224007 100755 --- a/packages/slimkit-plus-feed/src/API2/LikeController.php +++ b/packages/slimkit-plus-feed/src/API2/LikeController.php @@ -31,10 +31,11 @@ class LikeController extends Controller /** * Get feed likes. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return mixed + * * @author Seven Du */ public function index(Request $request, ResponseContract $response, FeedModel $feed) @@ -78,10 +79,11 @@ public function index(Request $request, ResponseContract $response, FeedModel $f /** * 用户点赞接口. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return mixed + * * @author Seven Du */ public function store(Request $request, ResponseContract $response, FeedModel $feed) @@ -102,10 +104,11 @@ public function store(Request $request, ResponseContract $response, FeedModel $f /** * 取消动态赞. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return mixed + * * @author Seven Du */ public function destroy(Request $request, ResponseContract $response, FeedModel $feed) diff --git a/packages/slimkit-plus-feed/src/API2/NewCommentPinnedController.php b/packages/slimkit-plus-feed/src/API2/NewCommentPinnedController.php index 5c22ccfc5..03a9dd3fb 100644 --- a/packages/slimkit-plus-feed/src/API2/NewCommentPinnedController.php +++ b/packages/slimkit-plus-feed/src/API2/NewCommentPinnedController.php @@ -36,13 +36,14 @@ class NewCommentPinnedController extends Controller /** * 固定评论. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Carbon\Carbon $dateTime - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed - * @param \Zhiyi\Plus\Models\Comment $comment - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Carbon\Carbon $dateTime + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Zhiyi\Plus\Models\Comment $comment + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned * @return mixed + * * @author BS <414606094@qq.com> */ public function pass( @@ -93,11 +94,12 @@ public function pass( /** * 拒绝置顶. * - * @param Request $request - * @param ResponseContract $response - * @param Carbon $dateTime - * @param FeedPinnedModel $pinned + * @param Request $request + * @param ResponseContract $response + * @param Carbon $dateTime + * @param FeedPinnedModel $pinned * @return mixed + * * @author BS <414606094@qq.com> */ public function reject( diff --git a/packages/slimkit-plus-feed/src/API2/NewPinnedController.php b/packages/slimkit-plus-feed/src/API2/NewPinnedController.php index 478a57860..1286681e5 100644 --- a/packages/slimkit-plus-feed/src/API2/NewPinnedController.php +++ b/packages/slimkit-plus-feed/src/API2/NewPinnedController.php @@ -49,12 +49,13 @@ public function __construct() /** * 申请动态评论置顶. * - * @param Request $request - * @param ResponseContract $response - * @param FeedModel $feed - * @param CommentModel $comment - * @param Carbon $datetime + * @param Request $request + * @param ResponseContract $response + * @param FeedModel $feed + * @param CommentModel $comment + * @param Carbon $datetime * @return mixed + * * @author BS <414606094@qq.com> */ public function commentPinned(Request $request, FeedModel $feed, CommentModel $comment, Carbon $datetime) @@ -122,10 +123,11 @@ public function commentPinned(Request $request, FeedModel $feed, CommentModel $c /** * 申请动态置顶. * - * @param Request $request - * @param FeedModel $feed - * @param Carbon $datetime + * @param Request $request + * @param FeedModel $feed + * @param Carbon $datetime * @return mixed + * * @author BS <414606094@qq.com> */ public function feedPinned(Request $request, FeedModel $feed, Carbon $datetime) @@ -165,10 +167,11 @@ public function feedPinned(Request $request, FeedModel $feed, Carbon $datetime) /** * 基础验证. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned - * @param callable $call + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned + * @param callable $call * @return mixed + * * @author BS <414606094@qq.com> */ public function validateBase(Request $request, FeedPinnedModel $pinned, callable $call) diff --git a/packages/slimkit-plus-feed/src/API2/NewRewardController.php b/packages/slimkit-plus-feed/src/API2/NewRewardController.php index ea89919f1..93c399b16 100755 --- a/packages/slimkit-plus-feed/src/API2/NewRewardController.php +++ b/packages/slimkit-plus-feed/src/API2/NewRewardController.php @@ -50,9 +50,10 @@ public function __construct() * @param Request $request * @param int $feed * @param UserProcess $process - * * @return mix + * * @throws \Exception + * * @author bs<414606094@qq.com> */ public function reward(Request $request, int $feed, UserProcess $process) diff --git a/packages/slimkit-plus-feed/src/API2/PinnedController.php b/packages/slimkit-plus-feed/src/API2/PinnedController.php index 4a2ed0da8..fc087ce35 100755 --- a/packages/slimkit-plus-feed/src/API2/PinnedController.php +++ b/packages/slimkit-plus-feed/src/API2/PinnedController.php @@ -44,7 +44,8 @@ class PinnedController extends Controller /** * Create the controller instance. * - * @param \Illuminate\Contracts\Foundation\Application $app + * @param \Illuminate\Contracts\Foundation\Application $app + * * @author Seven Du */ public function __construct(ApplicationContract $app) @@ -55,11 +56,12 @@ public function __construct(ApplicationContract $app) /** * 申请评论置顶. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed - * @param \Zhiyi\Plus\Models\Comment $comment + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Zhiyi\Plus\Models\Comment $comment * @return mixed + * * @author Seven Du */ public function commentPinned(Request $request, ResponseContract $response, FeedModel $feed, CommentModel $comment, Carbon $datetime) @@ -128,10 +130,11 @@ public function commentPinned(Request $request, ResponseContract $response, Feed /** * 申请动态置顶. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return mixed + * * @author Seven Du */ public function feedPinned(Request $request, ResponseContract $response, FeedModel $feed, Carbon $datetime) @@ -174,11 +177,12 @@ public function feedPinned(Request $request, ResponseContract $response, FeedMod /** * 保存所有数据库记录. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\WalletCharge $charge - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\WalletCharge $charge + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned * @return mixed + * * @author Seven Du */ public function save( @@ -213,10 +217,11 @@ public function save( /** * 基础验证. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned - * @param callable $call + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned + * @param callable $call * @return mixed + * * @author Seven Du */ public function validateBase(Request $request, FeedPinnedModel $pinned, callable $call) diff --git a/packages/slimkit-plus-feed/src/API2/RankController.php b/packages/slimkit-plus-feed/src/API2/RankController.php index 3439ba619..aaccb3287 100755 --- a/packages/slimkit-plus-feed/src/API2/RankController.php +++ b/packages/slimkit-plus-feed/src/API2/RankController.php @@ -33,10 +33,11 @@ class RankController extends Controller * 动态排行. * * @author bs<414606094@qq.com> - * @param Illuminate\Http\Request $request - * @param Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feedModel - * @param Carbon\Carbon $datetime - * @param Illuminate\Contracts\Routing\ResponseFactory $response + * + * @param Illuminate\Http\Request $request + * @param Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feedModel + * @param Carbon\Carbon $datetime + * @param Illuminate\Contracts\Routing\ResponseFactory $response * @return mixed */ public function index(Request $request, FeedModel $feedModel, Carbon $datetime, ResponseContract $response) diff --git a/packages/slimkit-plus-feed/src/API2/ReportController.php b/packages/slimkit-plus-feed/src/API2/ReportController.php index 957a2e78a..973f7a232 100755 --- a/packages/slimkit-plus-feed/src/API2/ReportController.php +++ b/packages/slimkit-plus-feed/src/API2/ReportController.php @@ -30,10 +30,11 @@ class ReportController extends Controller /** * 举报一条动态. * - * @param Request $request - * @param FeedModel $feed - * @param ReportModel $reportModel + * @param Request $request + * @param FeedModel $feed + * @param ReportModel $reportModel * @return mixed + * * @author BS <414606094@qq.com> */ public function feed(Request $request, FeedModel $feed, ReportModel $reportModel) diff --git a/packages/slimkit-plus-feed/src/API2/RewardController.php b/packages/slimkit-plus-feed/src/API2/RewardController.php index bf03936fb..515bbe8c0 100644 --- a/packages/slimkit-plus-feed/src/API2/RewardController.php +++ b/packages/slimkit-plus-feed/src/API2/RewardController.php @@ -53,9 +53,10 @@ public function __construct(CommonConfig $configModel) * @param Request $request * @param Feed $feed * @param WalletCharge $charge - * * @return mix + * * @throws \Throwable + * * @author bs<414606094@qq.com> */ public function reward(Request $request, Feed $feed, WalletCharge $charge) @@ -164,8 +165,9 @@ public function reward(Request $request, Feed $feed, WalletCharge $charge) * 一条动态的打赏列表. * * @author bs<414606094@qq.com> - * @param Request $request - * @param Feed $feed + * + * @param Request $request + * @param Feed $feed * @return mix */ public function index(Request $request, Feed $feed) diff --git a/packages/slimkit-plus-feed/src/AdminControllers/CommentController.php b/packages/slimkit-plus-feed/src/AdminControllers/CommentController.php index 344a9c718..666277909 100755 --- a/packages/slimkit-plus-feed/src/AdminControllers/CommentController.php +++ b/packages/slimkit-plus-feed/src/AdminControllers/CommentController.php @@ -44,12 +44,13 @@ class CommentController extends Controller /** * 获取评论列表. * - * @param Request $request - * @param Comment $commentModel - * @param Carbon $datetime - * @param FeedPinned $feedPinned - * @param User $user + * @param Request $request + * @param Comment $commentModel + * @param Carbon $datetime + * @param FeedPinned $feedPinned + * @param User $user * @return mixed + * * @author Seven Du */ public function show(Request $request, Comment $commentModel, Carbon $datetime, FeedPinned $feedPinned, User $user) @@ -197,9 +198,11 @@ public function show(Request $request, Comment $commentModel, Carbon $datetime, /** * Delete comment. * - * @param Comment $comment + * @param Comment $comment * @return mixed + * * @throws Exception + * * @author Seven Du */ public function delete(Comment $comment) @@ -255,9 +258,10 @@ public function delete(Comment $comment) /** * 同意评论置顶申请. - * @param Comment $comment - * @param FeedPinned $pinned [description] - * @param Carbon $datetime [description] + * + * @param Comment $comment + * @param FeedPinned $pinned [description] + * @param Carbon $datetime [description] * @return JsonResponse [type] [description] */ public function accept(Comment $comment, FeedPinned $pinned, Carbon $datetime) @@ -325,8 +329,10 @@ public function set(Request $request, Comment $comment, FeedPinned $pinned, Carb /** * 驳回评论置顶. - * @param FeedPinned $pinned + * + * @param FeedPinned $pinned * @return JsonResponse + * * @throws Exception */ public function reject(FeedPinned $pinned) diff --git a/packages/slimkit-plus-feed/src/AdminControllers/FeedController.php b/packages/slimkit-plus-feed/src/AdminControllers/FeedController.php index 8eaacfc52..186e1238f 100755 --- a/packages/slimkit-plus-feed/src/AdminControllers/FeedController.php +++ b/packages/slimkit-plus-feed/src/AdminControllers/FeedController.php @@ -36,9 +36,10 @@ class FeedController extends Controller /** * Get feeds. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $model + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $model * @return mixed + * * @author Seven Du */ public function index(Request $request, Feed $model, Carbon $datetime, User $user) @@ -173,9 +174,10 @@ public function index(Request $request, Feed $model, Carbon $datetime, User $use /** * Get deleted feeds. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $model + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $model * @return mixed + * * @author Seven Du */ public function deleted(Request $request, Feed $model) @@ -247,9 +249,10 @@ public function restore(Request $request) /** * Delete feed. * - * @param \Illuminate\Contracts\Cache\Repository $cache - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param \Illuminate\Contracts\Cache\Repository $cache + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return mixed + * * @author Seven Du */ public function destroy(CacheContract $cache, Feed $feed) diff --git a/packages/slimkit-plus-feed/src/AdminControllers/FeedPinnedController.php b/packages/slimkit-plus-feed/src/AdminControllers/FeedPinnedController.php index 1ccc3b571..0cb05bcb9 100755 --- a/packages/slimkit-plus-feed/src/AdminControllers/FeedPinnedController.php +++ b/packages/slimkit-plus-feed/src/AdminControllers/FeedPinnedController.php @@ -149,8 +149,9 @@ public function set(Request $request, Feed $feed, Carbon $datetime) /** * 撤销置顶. - * @param Feed $feed [description] - * @param FeedPinned $pinned [description] + * + * @param Feed $feed [description] + * @param FeedPinned $pinned [description] * @return JsonResponse [type] [description] */ public function destroy(Feed $feed, FeedPinned $pinned) diff --git a/packages/slimkit-plus-feed/src/AdminControllers/FileController.php b/packages/slimkit-plus-feed/src/AdminControllers/FileController.php index 1fbfed1b0..bf1270866 100755 --- a/packages/slimkit-plus-feed/src/AdminControllers/FileController.php +++ b/packages/slimkit-plus-feed/src/AdminControllers/FileController.php @@ -31,11 +31,12 @@ class FileController extends Controller /** * Get file. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Cdn\UrlManager $manager - * @param \Zhiyi\Plus\Models\FileWith $fileWith + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Cdn\UrlManager $manager + * @param \Zhiyi\Plus\Models\FileWith $fileWith * @return mixed + * * @author Seven Du */ public function show(Request $request, ResponseContract $response, CdnUrlManager $cdn, FileWithModel $file) diff --git a/packages/slimkit-plus-feed/src/AdminControllers/HomeController.php b/packages/slimkit-plus-feed/src/AdminControllers/HomeController.php index dcae3ddaa..d41ea9e09 100755 --- a/packages/slimkit-plus-feed/src/AdminControllers/HomeController.php +++ b/packages/slimkit-plus-feed/src/AdminControllers/HomeController.php @@ -34,6 +34,7 @@ class HomeController extends Controller * feed management background entry. * * @return mixed + * * @author Seven Du */ public function show() @@ -49,6 +50,7 @@ public function show() * 获取分享统计信息. * * @return mixed + * * @author Seven Du */ public function statistics(Request $request, Feed $feedModel, Comment $commentModel, Carbon $datetime) @@ -139,7 +141,8 @@ public function statistics(Request $request, Feed $feedModel, Comment $commentMo /** * 关闭应用打赏. - * @param Request $request [description] + * + * @param Request $request [description] * @return [type] [description] */ public function handleRewardStatus(Request $request) diff --git a/packages/slimkit-plus-feed/src/FeedServiceProvider.php b/packages/slimkit-plus-feed/src/FeedServiceProvider.php index 0fd9e685c..61d521b7c 100755 --- a/packages/slimkit-plus-feed/src/FeedServiceProvider.php +++ b/packages/slimkit-plus-feed/src/FeedServiceProvider.php @@ -35,6 +35,7 @@ class FeedServiceProvider extends ServiceProvider * Bootstrap the provider. * * @return void + * * @author Seven Du */ public function boot() @@ -95,6 +96,7 @@ public function boot() * register provided to provider. * * @return void + * * @author Seven Du */ public function register() @@ -113,6 +115,7 @@ public function register() * Register model events. * * @return void + * * @author Seven Du */ protected function registerObserves() @@ -124,6 +127,7 @@ protected function registerObserves() * Register route. * * @return void + * * @author Seven Du */ protected function routeMap() diff --git a/packages/slimkit-plus-feed/src/FormRequest/API2/StoreFeedComment.php b/packages/slimkit-plus-feed/src/FormRequest/API2/StoreFeedComment.php index 497e7ed50..d1bfd7e45 100755 --- a/packages/slimkit-plus-feed/src/FormRequest/API2/StoreFeedComment.php +++ b/packages/slimkit-plus-feed/src/FormRequest/API2/StoreFeedComment.php @@ -30,6 +30,7 @@ class StoreFeedComment extends FormRequest * authorization check. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -41,6 +42,7 @@ public function authorize(): bool * get the validator rules. * * @return array + * * @author Seven Du */ public function rules(): array @@ -58,6 +60,7 @@ public function rules(): array * Get the validator messages. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/packages/slimkit-plus-feed/src/FormRequest/API2/StoreFeedPost.php b/packages/slimkit-plus-feed/src/FormRequest/API2/StoreFeedPost.php index 6389bd43f..0ef5609a4 100755 --- a/packages/slimkit-plus-feed/src/FormRequest/API2/StoreFeedPost.php +++ b/packages/slimkit-plus-feed/src/FormRequest/API2/StoreFeedPost.php @@ -31,6 +31,7 @@ class StoreFeedPost extends FormRequest * authorization check. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -43,6 +44,7 @@ public function authorize(): bool * get the validator rules. * * @return array + * * @author Seven Du */ public function rules(): array @@ -92,6 +94,7 @@ public function rules(): array * Get the validator rule messages. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/packages/slimkit-plus-feed/src/Middleware/CheckFeedByFeedId.php b/packages/slimkit-plus-feed/src/Middleware/CheckFeedByFeedId.php index 70c243c6e..fbeb68d15 100755 --- a/packages/slimkit-plus-feed/src/Middleware/CheckFeedByFeedId.php +++ b/packages/slimkit-plus-feed/src/Middleware/CheckFeedByFeedId.php @@ -29,9 +29,8 @@ class CheckFeedByFeedId /** * 验证动态是否存在. * - * @param \Illuminate\Http\Request $request - * @param \Closure $next - * + * @param \Illuminate\Http\Request $request + * @param \Closure $next * @return mixed */ public function handle(Request $request, Closure $next) diff --git a/packages/slimkit-plus-feed/src/Middleware/VerifyCommentContent.php b/packages/slimkit-plus-feed/src/Middleware/VerifyCommentContent.php index fec531af8..83feba611 100755 --- a/packages/slimkit-plus-feed/src/Middleware/VerifyCommentContent.php +++ b/packages/slimkit-plus-feed/src/Middleware/VerifyCommentContent.php @@ -28,9 +28,8 @@ class VerifyCommentContent /** * check if comment_content exits. * - * @param \Illuminate\Http\Request $request - * @param \Closure $next - * + * @param \Illuminate\Http\Request $request + * @param \Closure $next * @return mixed */ public function handle(Request $request, Closure $next) diff --git a/packages/slimkit-plus-feed/src/Models/Concerns/HasFeedCollect.php b/packages/slimkit-plus-feed/src/Models/Concerns/HasFeedCollect.php index b5f58f082..871dfd06a 100755 --- a/packages/slimkit-plus-feed/src/Models/Concerns/HasFeedCollect.php +++ b/packages/slimkit-plus-feed/src/Models/Concerns/HasFeedCollect.php @@ -30,6 +30,7 @@ trait HasFeedCollect * 动态收藏用户列表. * * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany + * * @author Seven Du */ public function collections() @@ -43,8 +44,8 @@ public function collections() * check if user has collected. * * @param int $user - * * @return bool + * * @author Seven Du */ public function collected(int $user): bool @@ -63,8 +64,8 @@ public function collected(int $user): bool * 动态收藏. * * @param int $user - * * @return mixed + * * @author Seven Du */ public function collect(int $user) @@ -78,8 +79,8 @@ public function collect(int $user) * 取消动态收藏. * * @param int $user - * * @return mixed + * * @author Seven Du */ public function uncollect(int $user) @@ -94,8 +95,8 @@ public function uncollect(int $user) * * @param int $feed * @param int $user - * * @return void + * * @author Seven Du */ public function forgetCollet(int $feed, int $user) diff --git a/packages/slimkit-plus-feed/src/Models/Feed.php b/packages/slimkit-plus-feed/src/Models/Feed.php index 007b88ba3..d371e0b42 100755 --- a/packages/slimkit-plus-feed/src/Models/Feed.php +++ b/packages/slimkit-plus-feed/src/Models/Feed.php @@ -100,6 +100,7 @@ public static function boot() * Has feed pinned. * * @return HasOne + * * @author Seven Du */ public function pinned() @@ -114,6 +115,7 @@ public function pinned() * @Author Wayne * @DateTime 2018-04-13 * @Email qiaobin@zhiyicx.com + * * @return HasMany */ public function blacks() @@ -125,6 +127,7 @@ public function blacks() * Get feed images. * * @return HasMany + * * @author Seven Du */ public function images() @@ -137,6 +140,7 @@ public function images() * 动态付费节点. * * @return HasOne + * * @author Seven Du */ public function paidNode() @@ -160,6 +164,7 @@ public function user() * Has comments. * * @return MorphMany + * * @author Seven Du */ public function comments() @@ -171,6 +176,7 @@ public function comments() * Has pinned comments. * * @return BelongsToMany + * * @author Seven Du */ public function pinnedComments() @@ -198,7 +204,6 @@ public function pinnedingComments() * * @param Builder $query * @param int $userId - * * @return Builder */ public function scopeByUserId(Builder $query, int $userId): Builder @@ -211,8 +216,8 @@ public function scopeByUserId(Builder $query, int $userId): Builder * * @param Builder $query [description] * @param int $feedId [description] - * * @return Builder + * * @author bs<414606094@qq.com> */ public function scopeByFeedId(Builder $query, int $feedId): Builder @@ -224,8 +229,8 @@ public function scopeByFeedId(Builder $query, int $feedId): Builder * 筛选已审核动态 * * @param Builder $query [description] - * * @return Builder + * * @author bs<414606094@qq.com> */ public function scopeByAudit(Builder $query): Builder @@ -247,6 +252,7 @@ public function collection() * Has reports. * * @return MorphMany + * * @author bs<414606094@qq.com> */ public function reports() diff --git a/packages/slimkit-plus-feed/src/Models/FeedPinned.php b/packages/slimkit-plus-feed/src/Models/FeedPinned.php index a17488584..13f5edf35 100755 --- a/packages/slimkit-plus-feed/src/Models/FeedPinned.php +++ b/packages/slimkit-plus-feed/src/Models/FeedPinned.php @@ -44,6 +44,7 @@ public static function boot() * Has user. * * @return HasOne + * * @author Seven Du */ public function user() @@ -55,6 +56,7 @@ public function user() * Has feed. * * @return HasOne + * * @author Seven Du */ public function feed() @@ -71,6 +73,7 @@ public function commentFeed() * Has feed comment. * * @return HasOne + * * @author Seven Du */ public function comment() diff --git a/packages/slimkit-plus-feed/src/Models/Relations/FeedHasLike.php b/packages/slimkit-plus-feed/src/Models/Relations/FeedHasLike.php index fc4b0c11f..7a076fb07 100755 --- a/packages/slimkit-plus-feed/src/Models/Relations/FeedHasLike.php +++ b/packages/slimkit-plus-feed/src/Models/Relations/FeedHasLike.php @@ -32,6 +32,7 @@ trait FeedHasLike * Has likes. * * @return MorphMany + * * @author Seven Du */ public function likes() @@ -43,8 +44,8 @@ public function likes() * Check user like. * * @param mixed $user - * * @return bool + * * @author Seven Du */ public function liked($user): bool @@ -68,8 +69,8 @@ function () use ($user) { * Like feed. * * @param mixed $user - * * @return mixed + * * @author Seven Du */ public function like($user) @@ -97,8 +98,8 @@ public function like($user) * Unlike feed. * * @param mixed $user - * * @return mixed + * * @author Seven Du */ public function unlike($user) @@ -124,8 +125,8 @@ public function unlike($user) * Forget like cache. * * @param mixed $user - * * @return void + * * @author Seven Du */ public function forgetLike($user) diff --git a/packages/slimkit-plus-feed/src/Models/Relations/FeedHasReward.php b/packages/slimkit-plus-feed/src/Models/Relations/FeedHasReward.php index 31413cfd6..a827db1d5 100755 --- a/packages/slimkit-plus-feed/src/Models/Relations/FeedHasReward.php +++ b/packages/slimkit-plus-feed/src/Models/Relations/FeedHasReward.php @@ -36,8 +36,9 @@ public function rewards() * Reward a author of feed. * * @author bs<414606094@qq.com> - * @param mix $user - * @param float $amount + * + * @param mix $user + * @param float $amount * @return mix */ public function reward($user, $amount) @@ -62,6 +63,7 @@ public function reward($user, $amount) * 打赏总数统计 * * @author bs<414606094@qq.com> + * * @return mix */ public function rewardCount() diff --git a/packages/slimkit-plus-feed/src/Repository/Feed.php b/packages/slimkit-plus-feed/src/Repository/Feed.php index bd3f3c44d..512ec14b2 100755 --- a/packages/slimkit-plus-feed/src/Repository/Feed.php +++ b/packages/slimkit-plus-feed/src/Repository/Feed.php @@ -65,8 +65,8 @@ public function __construct( * * @param int $id * @param array $columns - * * @return FeedModel + * * @author Seven Du */ public function find($id, $columns = ['*']) @@ -82,6 +82,7 @@ public function find($id, $columns = ['*']) * Feed images. * * @return Collection|static[] + * * @author Seven Du */ public function images() @@ -108,6 +109,7 @@ function () { * preview likes. * * @return FeedModel + * * @author Seven Du */ public function previewLike() @@ -133,8 +135,8 @@ public function previewLike() * Format feed data. * * @param int $user - * * @return FeedModel + * * @author Seven Du */ public function format(int $user = 0): FeedModel @@ -184,8 +186,8 @@ public function format(int $user = 0): FeedModel * Set feed model. * * @param FeedModel $model - * * @return Feed + * * @author Seven Du */ public function setModel(FeedModel $model) @@ -204,6 +206,7 @@ public function forget($key) * Ask the feed list of comments data, give priority to return to the top comments. * * @return FeedModel + * * @author bs<414606094@qq.com> */ public function previewComments() diff --git a/packages/slimkit-plus-feed/src/RouteRegistrar.php b/packages/slimkit-plus-feed/src/RouteRegistrar.php index fa6b5779d..b4fdd04ba 100755 --- a/packages/slimkit-plus-feed/src/RouteRegistrar.php +++ b/packages/slimkit-plus-feed/src/RouteRegistrar.php @@ -35,6 +35,7 @@ class RouteRegistrar * Create a new route registrar instance. * * @param \Illuminate\Contracts\Routing\Registrar $router + * * @author Seven Du */ public function __construct(RouterContract $router) @@ -46,6 +47,7 @@ public function __construct(RouterContract $router) * Register all. * * @return void + * * @author Seven Du */ public function all() @@ -58,6 +60,7 @@ public function all() * Register admin routes. * * @return void + * * @author Seven Du */ public function forAdmin() @@ -77,6 +80,7 @@ public function forAdmin() * Register api 2 routes. * * @return void + * * @author Seven Du */ public function forApi2() diff --git a/packages/slimkit-plus-feed/src/Services/FeedCount.php b/packages/slimkit-plus-feed/src/Services/FeedCount.php index 662702931..cba2c5047 100755 --- a/packages/slimkit-plus-feed/src/Services/FeedCount.php +++ b/packages/slimkit-plus-feed/src/Services/FeedCount.php @@ -64,9 +64,10 @@ protected function checkEmptyData($uid, $countKey) * 统计数量. * * @author bs<414606094@qq.com> + * * @param [type] $uid [description] * @param [type] $countKey [description] - * @param string $method [description] + * @param string $method [description] * @return [type] [description] */ public function count($uid, $countKey, $method = 'increment', $countnum = 1) diff --git a/packages/slimkit-plus-feed/src/Traits/PaginatorPage.php b/packages/slimkit-plus-feed/src/Traits/PaginatorPage.php index 4addd612d..b4102b9e4 100755 --- a/packages/slimkit-plus-feed/src/Traits/PaginatorPage.php +++ b/packages/slimkit-plus-feed/src/Traits/PaginatorPage.php @@ -27,8 +27,9 @@ trait PaginatorPage /** * 获取下一页页码. * - * @param PaginatorContract $paginator + * @param PaginatorContract $paginator * @return int|null|void + * * @author Seven Du */ protected function getNextPage(Paginator $paginator) @@ -41,8 +42,9 @@ protected function getNextPage(Paginator $paginator) /** * 获取上一页的页码. * - * @param PaginatorContract $paginator + * @param PaginatorContract $paginator * @return int|null|void + * * @author Seven Du */ protected function getPrevPage(Paginator $paginator) diff --git a/packages/slimkit-plus-feed/tests/Feature/API2/DeleteFeedCommentTest.php b/packages/slimkit-plus-feed/tests/Feature/API2/DeleteFeedCommentTest.php index 8d76a584f..020d8a405 100644 --- a/packages/slimkit-plus-feed/tests/Feature/API2/DeleteFeedCommentTest.php +++ b/packages/slimkit-plus-feed/tests/Feature/API2/DeleteFeedCommentTest.php @@ -81,6 +81,7 @@ protected function addFeed($user) * @param $user * @param $feed * @return mixed + * * @throws \Exception */ protected function addFeedComment($user, $feed) @@ -99,6 +100,7 @@ protected function addFeedComment($user, $feed) * 删除动态评论. * * @return mixed + * * @throws \Exception */ public function testDeleteFeedComment() diff --git a/packages/slimkit-plus-feed/tests/Feature/API2/GetFeedCommentTest.php b/packages/slimkit-plus-feed/tests/Feature/API2/GetFeedCommentTest.php index 6215461d9..a6059c03a 100644 --- a/packages/slimkit-plus-feed/tests/Feature/API2/GetFeedCommentTest.php +++ b/packages/slimkit-plus-feed/tests/Feature/API2/GetFeedCommentTest.php @@ -60,6 +60,7 @@ protected function createUser(): UserModel * * @param $user * @return mixed + * * @throws \Exception */ protected function addFeed($user) @@ -81,6 +82,7 @@ protected function addFeed($user) * @param $user * @param $feed * @return mixed + * * @throws \Exception */ protected function addFeedComment($user, $feed) diff --git a/packages/slimkit-plus-feed/tests/Feature/API2/SendFeedCommentTest.php b/packages/slimkit-plus-feed/tests/Feature/API2/SendFeedCommentTest.php index 006b48e98..aee5063ed 100644 --- a/packages/slimkit-plus-feed/tests/Feature/API2/SendFeedCommentTest.php +++ b/packages/slimkit-plus-feed/tests/Feature/API2/SendFeedCommentTest.php @@ -61,6 +61,7 @@ protected function createUser(): UserModel * * @param $user * @return mixed + * * @throws \Exception */ protected function addFeed($user) diff --git a/packages/slimkit-plus-feed/tests/Feature/API2/SendTextFeedTest.php b/packages/slimkit-plus-feed/tests/Feature/API2/SendTextFeedTest.php index 0285bb9ad..b295ed95b 100644 --- a/packages/slimkit-plus-feed/tests/Feature/API2/SendTextFeedTest.php +++ b/packages/slimkit-plus-feed/tests/Feature/API2/SendTextFeedTest.php @@ -34,6 +34,7 @@ class SendTextFeedTest extends TestCase * Create the test need user. * * @return \Zhiyi\Plus\Models\User + * * @author Seven Du */ protected function createUser(): UserModel @@ -60,6 +61,7 @@ protected function createUser(): UserModel * Test send a public feed. * * @return void + * * @author Seven Du */ public function testSendPublic() @@ -81,6 +83,7 @@ public function testSendPublic() * Test not send ability user send feed. * * @return void + * * @author Seven Du */ public function testSendNotSendAbility() diff --git a/packages/slimkit-plus-id/src/Admin/Controllers/ClientsController.php b/packages/slimkit-plus-id/src/Admin/Controllers/ClientsController.php index 59373ad95..663caa373 100644 --- a/packages/slimkit-plus-id/src/Admin/Controllers/ClientsController.php +++ b/packages/slimkit-plus-id/src/Admin/Controllers/ClientsController.php @@ -30,6 +30,7 @@ class ClientsController * Get all clients. * * @return mixed + * * @author Seven Du */ public function index() @@ -40,8 +41,9 @@ public function index() /** * Store a client. * - * @param \SlimKit\PlusID\Admin\Requests\CreateClientRequest $request + * @param \SlimKit\PlusID\Admin\Requests\CreateClientRequest $request * @return mixed + * * @author Seven Du */ public function store(CreateClientRequest $request) @@ -65,8 +67,9 @@ public function store(CreateClientRequest $request) /** * Destory a client. * - * @param \SlimKit\PlusID\Models\Client $client + * @param \SlimKit\PlusID\Models\Client $client * @return mixed + * * @author Seven Du */ public function destroy(ClientModel $client) @@ -79,9 +82,10 @@ public function destroy(ClientModel $client) /** * Update a client. * - * @param \SlimKit\PlusID\Admin\Requests\UpdateClientRequest $request - * @param \SlimKit\PlusID\Models\Client $client + * @param \SlimKit\PlusID\Admin\Requests\UpdateClientRequest $request + * @param \SlimKit\PlusID\Models\Client $client * @return mixed + * * @author Seven Du */ public function update(UpdateClientRequest $request, ClientModel $client) diff --git a/packages/slimkit-plus-id/src/Admin/Requests/CreateClientRequest.php b/packages/slimkit-plus-id/src/Admin/Requests/CreateClientRequest.php index e5af5fe1e..090cc366a 100644 --- a/packages/slimkit-plus-id/src/Admin/Requests/CreateClientRequest.php +++ b/packages/slimkit-plus-id/src/Admin/Requests/CreateClientRequest.php @@ -28,6 +28,7 @@ class CreateClientRequest extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/packages/slimkit-plus-id/src/Handlers/DevPackageHandler.php b/packages/slimkit-plus-id/src/Handlers/DevPackageHandler.php index ae19e937a..21087b0ea 100644 --- a/packages/slimkit-plus-id/src/Handlers/DevPackageHandler.php +++ b/packages/slimkit-plus-id/src/Handlers/DevPackageHandler.php @@ -48,7 +48,6 @@ public function __construct(ApplicationContract $app) * Create a migration file. * * @param \Illuminate\Console\Command $command - * * @return mixed */ public function makeMigrationHandle(Command $command) @@ -89,8 +88,8 @@ public function makeMigrationHandle(Command $command) * Create a database seeder. * * @param \Illuminate\Console\Command $command - * * @return mixed + * * @author Seven Du */ public function makeSeederHandle(Command $command) @@ -129,8 +128,8 @@ public function makeSeederHandle(Command $command) * Make package model. * * @param \Illuminate\Console\Command $command - * * @return mixed + * * @author Seven Du */ public function makeModelHandle(Command $command) diff --git a/packages/slimkit-plus-id/src/Models/Client.php b/packages/slimkit-plus-id/src/Models/Client.php index 0c5bd7e51..41eb7f180 100644 --- a/packages/slimkit-plus-id/src/Models/Client.php +++ b/packages/slimkit-plus-id/src/Models/Client.php @@ -34,9 +34,10 @@ class Client extends Model /** * make sign. * - * @param array $action - * @param string $key + * @param array $action + * @param string $key * @return string + * * @author Seven Du */ public function sign(array $action, string $key = ''): string diff --git a/packages/slimkit-plus-id/src/Providers/AppServiceProvider.php b/packages/slimkit-plus-id/src/Providers/AppServiceProvider.php index efd8ec0f7..d5355c874 100644 --- a/packages/slimkit-plus-id/src/Providers/AppServiceProvider.php +++ b/packages/slimkit-plus-id/src/Providers/AppServiceProvider.php @@ -144,8 +144,8 @@ protected function registerPackageHandlers() /** * Register handler. * - * @param string $name - * @param \Zhiyi\Plus\Support\PackageHandler|string $handler + * @param string $name + * @param \Zhiyi\Plus\Support\PackageHandler|string $handler * @return void */ private function loadHandleFrom(string $name, $handler) diff --git a/packages/slimkit-plus-id/src/Providers/ModelServiceProvider.php b/packages/slimkit-plus-id/src/Providers/ModelServiceProvider.php index ad76b46e8..10b14f3e9 100644 --- a/packages/slimkit-plus-id/src/Providers/ModelServiceProvider.php +++ b/packages/slimkit-plus-id/src/Providers/ModelServiceProvider.php @@ -67,8 +67,8 @@ protected function registerMorphMap() /** * Set or get the morph map for polymorphic relations. * - * @param array|null $map - * @param bool $merge + * @param array|null $map + * @param bool $merge * @return array */ protected function morphMap(array $map = null, bool $merge = true): array diff --git a/packages/slimkit-plus-id/src/Support/URL.php b/packages/slimkit-plus-id/src/Support/URL.php index 5094a566d..a720a9786 100644 --- a/packages/slimkit-plus-id/src/Support/URL.php +++ b/packages/slimkit-plus-id/src/Support/URL.php @@ -83,7 +83,8 @@ class URL /** * Create the URL parse. * - * @param string $uri + * @param string $uri + * * @author Seven Du */ public function __construct(string $uri) @@ -120,8 +121,9 @@ public function __construct(string $uri) /** * Get the URL protected. * - * @param string $key + * @param string $key * @return mixed + * * @author Seven Du */ public function get(string $key) @@ -132,8 +134,9 @@ public function get(string $key) /** * Set the URL protected. * - * @param string $key - * @param mixed $value + * @param string $key + * @param mixed $value + * * @author Seven Du */ public function set(string $key, $value) @@ -146,8 +149,9 @@ public function set(string $key, $value) /** * Add a query key. * - * @param string $key - * @param string|array $value + * @param string $key + * @param string|array $value + * * @author Seven Du */ public function addQuery(string $key, $value) @@ -185,6 +189,7 @@ public function make(): string * Make url to string. * * @return string + * * @author Seven Du */ public function __toString() diff --git a/packages/slimkit-plus-music/database/seeds/DatabaseSeeder.php b/packages/slimkit-plus-music/database/seeds/DatabaseSeeder.php index 79db7a5c2..ed6d2b442 100644 --- a/packages/slimkit-plus-music/database/seeds/DatabaseSeeder.php +++ b/packages/slimkit-plus-music/database/seeds/DatabaseSeeder.php @@ -28,6 +28,7 @@ class DatabaseSeeder extends Seeder * Run the package seeder. * * @return void + * * @author Seven Du */ public function run() diff --git a/packages/slimkit-plus-music/src/API/Controllers/MusicCollectionController.php b/packages/slimkit-plus-music/src/API/Controllers/MusicCollectionController.php index cd85c443b..b2d0e869f 100644 --- a/packages/slimkit-plus-music/src/API/Controllers/MusicCollectionController.php +++ b/packages/slimkit-plus-music/src/API/Controllers/MusicCollectionController.php @@ -32,8 +32,9 @@ class MusicCollectionController extends Controller * 用户收藏列表. * * @author bs<414606094@qq.com> - * @param Request $request - * @param MusicSpecial $musicSpecialModel + * + * @param Request $request + * @param MusicSpecial $musicSpecialModel * @return json */ public function list(Request $request, MusicSpecial $musicSpecialModel) @@ -62,8 +63,9 @@ public function list(Request $request, MusicSpecial $musicSpecialModel) * 收藏专辑. * * @author bs<414606094@qq.com> - * @param Request $request - * @param MusicSpecial $special + * + * @param Request $request + * @param MusicSpecial $special * @return json */ public function store(Request $request, MusicSpecial $special) @@ -92,8 +94,9 @@ public function store(Request $request, MusicSpecial $special) * 取消收藏专辑. * * @author bs<414606094@qq.com> - * @param Request $request - * @param MusicSpecial $special + * + * @param Request $request + * @param MusicSpecial $special * @return json */ public function delete(Request $request, MusicSpecial $special) diff --git a/packages/slimkit-plus-music/src/API/Controllers/MusicCommentController.php b/packages/slimkit-plus-music/src/API/Controllers/MusicCommentController.php index 3842b803a..7ca17c240 100644 --- a/packages/slimkit-plus-music/src/API/Controllers/MusicCommentController.php +++ b/packages/slimkit-plus-music/src/API/Controllers/MusicCommentController.php @@ -36,9 +36,10 @@ class MusicCommentController extends Controller * 添加音乐评论. * * @author bs<414606094@qq.com> - * @param Request $request - * @param Music $music - * @param Comment $comment + * + * @param Request $request + * @param Music $music + * @param Comment $comment * @return json */ public function store(Request $request, Music $music, Comment $comment) @@ -77,8 +78,9 @@ public function store(Request $request, Music $music, Comment $comment) * 音乐评论列表. * * @author bs<414606094@qq.com> - * @param Request $request - * @param Music $music + * + * @param Request $request + * @param Music $music * @return json */ public function list(Request $request, Music $music) @@ -98,9 +100,10 @@ public function list(Request $request, Music $music) * 删除音乐评论. * * @author bs<414606094@qq.com> - * @param Request $request - * @param Music $music - * @param Comment $comment + * + * @param Request $request + * @param Music $music + * @param Comment $comment * @return json */ public function delete(Request $request, Music $music, Comment $comment) @@ -126,9 +129,10 @@ public function delete(Request $request, Music $music, Comment $comment) * 删除专辑评论. * * @author bs<414606094@qq.com> - * @param Request $request - * @param MusicSpecial $special - * @param Comment $comment + * + * @param Request $request + * @param MusicSpecial $special + * @param Comment $comment * @return json */ public function specialDelete(Request $request, MusicSpecial $special, Comment $comment) @@ -151,8 +155,9 @@ public function specialDelete(Request $request, MusicSpecial $special, Comment $ * 专辑评论列表. * * @author bs<414606094@qq.com> - * @param Request $request - * @param MusicSpecial $special + * + * @param Request $request + * @param MusicSpecial $special * @return json */ public function specialList(Request $request, MusicSpecial $special) @@ -176,9 +181,10 @@ public function specialList(Request $request, MusicSpecial $special) * 添加专辑评论. * * @author bs<414606094@qq.com> - * @param Request $request - * @param MusicSpecial $special - * @param Comment $comment + * + * @param Request $request + * @param MusicSpecial $special + * @param Comment $comment * @return json */ public function specialStore(Request $request, MusicSpecial $special, Comment $comment) diff --git a/packages/slimkit-plus-music/src/API/Controllers/MusicController.php b/packages/slimkit-plus-music/src/API/Controllers/MusicController.php index 03ae39299..a0ad4e3ba 100644 --- a/packages/slimkit-plus-music/src/API/Controllers/MusicController.php +++ b/packages/slimkit-plus-music/src/API/Controllers/MusicController.php @@ -28,7 +28,8 @@ class MusicController extends Controller { /** * List songs. - * @param \Illuminate\Http\Request $request + * + * @param \Illuminate\Http\Request $request * @return mixed */ public function index(Request $request) @@ -55,8 +56,9 @@ public function index(Request $request) * 专辑详情. * * @author bs<414606094@qq.com> - * @param Request $request - * @param Music $music + * + * @param Request $request + * @param Music $music * @return */ public function show(Request $request, Music $music) @@ -81,6 +83,7 @@ public function show(Request $request, Music $music) * 增加歌曲分享数. * * @author bs<414606094@qq.com> + * * @param Music $music * @return mixed */ diff --git a/packages/slimkit-plus-music/src/API/Controllers/MusicLikeController.php b/packages/slimkit-plus-music/src/API/Controllers/MusicLikeController.php index 9c80018a9..9180f119f 100644 --- a/packages/slimkit-plus-music/src/API/Controllers/MusicLikeController.php +++ b/packages/slimkit-plus-music/src/API/Controllers/MusicLikeController.php @@ -30,8 +30,9 @@ class MusicLikeController extends Controller * 点赞一个音乐. * * @author bs<414606094@qq.com> - * @param Request $request [description] - * @param Music $Music_id [description] + * + * @param Request $request [description] + * @param Music $Music_id [description] * @return [type] [description] */ public function like(Request $request, Music $music) @@ -53,8 +54,9 @@ public function like(Request $request, Music $music) * 取消点赞一个动态 * * @author bs<414606094@qq.com> - * @param Request $request - * @param Music $Music + * + * @param Request $request + * @param Music $Music * @return [type] */ public function cancel(Request $request, Music $music) diff --git a/packages/slimkit-plus-music/src/API/Controllers/MusicPaidController.php b/packages/slimkit-plus-music/src/API/Controllers/MusicPaidController.php index 343cc2a86..a56b877a7 100644 --- a/packages/slimkit-plus-music/src/API/Controllers/MusicPaidController.php +++ b/packages/slimkit-plus-music/src/API/Controllers/MusicPaidController.php @@ -31,8 +31,9 @@ class MusicPaidController extends Controller * Get the specials that the user has purchased. * * @author bs<414606094@qq.com> - * @param Illuminate\Http\Request $request - * @param Zhiyi\Component\ZhiyiPlus\PlusComponentMusic\Models\MusicSpecial $musicSpecial + * + * @param Illuminate\Http\Request $request + * @param Zhiyi\Component\ZhiyiPlus\PlusComponentMusic\Models\MusicSpecial $musicSpecial * @return mixed */ public function specials(Request $request, MusicSpecial $musicSpecial) @@ -69,8 +70,9 @@ public function specials(Request $request, MusicSpecial $musicSpecial) * Get the musics that the user has purchased. * * @author bs<414606094@qq.com> - * @param Illuminate\Http\Request $request - * @param Zhiyi\Component\ZhiyiPlus\PlusComponentMusic\Models\Music $musicModel + * + * @param Illuminate\Http\Request $request + * @param Zhiyi\Component\ZhiyiPlus\PlusComponentMusic\Models\Music $musicModel * @return mixed */ public function musics(Request $request, Music $musicModel) diff --git a/packages/slimkit-plus-music/src/API/Controllers/MusicSpecialController.php b/packages/slimkit-plus-music/src/API/Controllers/MusicSpecialController.php index f185a4c4c..f712de2ed 100644 --- a/packages/slimkit-plus-music/src/API/Controllers/MusicSpecialController.php +++ b/packages/slimkit-plus-music/src/API/Controllers/MusicSpecialController.php @@ -31,6 +31,7 @@ class MusicSpecialController extends Controller * 获取专辑列表. * * @author bs<414606094@qq.com> + * * @return [type] [description] */ public function list(Request $request, ResponseFactory $response) @@ -62,9 +63,10 @@ public function list(Request $request, ResponseFactory $response) * 专辑详情. * * @author bs<414606094@qq.com> - * @param Request $request - * @param MusicSpecial $special - * @param ResponseFactory $response + * + * @param Request $request + * @param MusicSpecial $special + * @param ResponseFactory $response * @return mix */ public function show(Request $request, MusicSpecial $special, ResponseFactory $response) @@ -99,7 +101,8 @@ public function show(Request $request, MusicSpecial $special, ResponseFactory $r * 增加分享数,供移动端分享专辑时调用. * * @author bs<414606094@qq.com> - * @param MusicSpecial $special_id + * + * @param MusicSpecial $special_id * @return mixed */ public function share(MusicSpecial $special) diff --git a/packages/slimkit-plus-music/src/Admin/CommentController.php b/packages/slimkit-plus-music/src/Admin/CommentController.php index 9d8fda4c7..dba2cb2f2 100644 --- a/packages/slimkit-plus-music/src/Admin/CommentController.php +++ b/packages/slimkit-plus-music/src/Admin/CommentController.php @@ -32,6 +32,7 @@ class CommentController extends Controller { /** * 所有歌曲应用相关评论. + * * @param Request $request * @param MusicComment $comment * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View @@ -71,8 +72,9 @@ public function lists(Request $request, MusicComment $comment) /** * 歌曲评论. - * @param Request $request [description] - * @param Music $music [description] + * + * @param Request $request [description] + * @param Music $music [description] * @return [type] [description] */ public function musicComments(Request $request, Music $music) @@ -102,8 +104,9 @@ function ($query) use ($keyword) { /** * 专辑评论. - * @param Request $request [description] - * @param MusicSpecial $special [description] + * + * @param Request $request [description] + * @param MusicSpecial $special [description] * @return [type] [description] */ public function specialComments(Request $request, MusicSpecial $special) @@ -130,9 +133,10 @@ function ($query) use ($special) { * 删除音乐评论. * * @author bs<414606094@qq.com> - * @param Request $request - * @param Music $music - * @param Comment $comment + * + * @param Request $request + * @param Music $music + * @param Comment $comment * @return json */ public function delete(Music $music, Comment $comment) @@ -153,9 +157,10 @@ public function delete(Music $music, Comment $comment) * 删除专辑评论. * * @author bs<414606094@qq.com> - * @param Request $request - * @param MusicSpecial $special - * @param Comment $comment + * + * @param Request $request + * @param MusicSpecial $special + * @param Comment $comment * @return json */ public function specialDelete(MusicSpecial $special, Comment $comment) diff --git a/packages/slimkit-plus-music/src/Admin/HomeController.php b/packages/slimkit-plus-music/src/Admin/HomeController.php index 7adace93a..dc2637988 100644 --- a/packages/slimkit-plus-music/src/Admin/HomeController.php +++ b/packages/slimkit-plus-music/src/Admin/HomeController.php @@ -42,6 +42,7 @@ class HomeController extends Controller * @param Request $request * @param Music $music * @return mixed + * * @author Seven Du */ public function show(Request $request, Music $music) @@ -77,8 +78,10 @@ public function show(Request $request, Music $music) /** * 删除音乐. - * @param Music $music + * + * @param Music $music * @return \Illuminate\Http\RedirectResponse + * * @throws \Exception */ public function handleDelete(Music $music) @@ -97,8 +100,9 @@ public function handleDelete(Music $music) /** * 查看专辑. - * @param Request $request [description] - * @param MusicSpecial $special + * + * @param Request $request [description] + * @param MusicSpecial $special * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View */ public function showSpecial(Request $request, MusicSpecial $special) @@ -124,8 +128,9 @@ public function showSpecial(Request $request, MusicSpecial $special) /** * 显示专辑详情. - * @param MusicSpecial $special - * @param CdnUrlManager $cdn + * + * @param MusicSpecial $special + * @param CdnUrlManager $cdn * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View */ public function specialDetail(MusicSpecial $special, CdnUrlManager $cdn) @@ -144,11 +149,12 @@ public function specialDetail(MusicSpecial $special, CdnUrlManager $cdn) /** * Get file. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Cdn\UrlManager $manager - * @param \Zhiyi\Plus\Models\FileWith $fileWith + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Cdn\UrlManager $manager + * @param \Zhiyi\Plus\Models\FileWith $fileWith * @return mixed + * * @author Seven Du */ protected function showStorage(CdnUrlManager $cdn, FileWithModel $fileWith, int $width = 200, int $height = 200, int $quality = 80) @@ -167,8 +173,10 @@ protected function showStorage(CdnUrlManager $cdn, FileWithModel $fileWith, int /** * 禁用专辑. - * @param MusicSpecial $special + * + * @param MusicSpecial $special * @return \Illuminate\Http\RedirectResponse + * * @throws \Throwable */ public function handleDisableSpecial(MusicSpecial $special) @@ -187,6 +195,7 @@ public function handleDisableSpecial(MusicSpecial $special) /** * 增加专辑页面. + * * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View */ public function handleAddSpecial() @@ -196,9 +205,11 @@ public function handleAddSpecial() /** * 保存专辑. - * @param SpecialAddRequest $request - * @param MusicSpecial $special + * + * @param SpecialAddRequest $request + * @param MusicSpecial $special * @return \Illuminate\Http\RedirectResponse + * * @throws \Throwable */ public function handleStoreSpecial(SpecialAddRequest $request, MusicSpecial $special) @@ -227,10 +238,12 @@ public function handleStoreSpecial(SpecialAddRequest $request, MusicSpecial $spe /** * 更改专辑. - * @param SpecialUpdateRequest $request - * @param MusicSpecial $special - * @param FileWithModel $fileWithModel + * + * @param SpecialUpdateRequest $request + * @param MusicSpecial $special + * @param FileWithModel $fileWithModel * @return \Illuminate\Http\RedirectResponse + * * @throws \Throwable */ public function handleUpdateSpecial(SpecialUpdateRequest $request, MusicSpecial $special, FileWithModel $fileWithModel) @@ -284,8 +297,9 @@ public function handleUpdateSpecial(SpecialUpdateRequest $request, MusicSpecial /** * 歌曲详情. - * @param MusicSpecial $special - * @param MusicSinger $singer + * + * @param MusicSpecial $special + * @param MusicSinger $singer * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View */ public function handleAddMuisc(Request $request, MusicSpecial $special, MusicSinger $singer) @@ -362,8 +376,9 @@ public function handleStoreMuisc(Request $request, Music $music) /** * 创建付费节点模型. * - * @param MusicAddRequest $request + * @param MusicAddRequest $request * @return mixed + * * @author Seven Du */ protected function makePaidNode(Request $request) @@ -386,8 +401,9 @@ protected function makePaidNode(Request $request) /** * 创建专辑付费节点. - * @param SpecialAddRequest $request [description] - * @param MusicSpecial $special + * + * @param SpecialAddRequest $request [description] + * @param MusicSpecial $special * @return PaidNodeModel|null */ protected function makeSpecialNode(SpecialAddRequest $request, MusicSpecial $special) @@ -408,7 +424,8 @@ protected function makeSpecialNode(SpecialAddRequest $request, MusicSpecial $spe /** * 创建专辑付费节点. - * @param SpecialAddRequest $request [description] + * + * @param SpecialAddRequest $request [description] * @return [type] [description] */ protected function updateSpecialNode(SpecialUpdateRequest $request, MusicSpecial $special) @@ -430,8 +447,9 @@ protected function updateSpecialNode(SpecialUpdateRequest $request, MusicSpecial /** * 创建文件使用模型. * - * @param StoreFeedPostRequest $request + * @param StoreFeedPostRequest $request * @return mixed + * * @author Seven Du */ protected function makeFileWith(Request $request) @@ -448,7 +466,8 @@ protected function makeFileWith(Request $request) /** * 添加专辑设置封面. - * @param SpecialAddRequest $request [description] + * + * @param SpecialAddRequest $request [description] * @return [type] [description] */ protected function makeSpecialFileWith(SpecialAddRequest $request) @@ -464,7 +483,8 @@ protected function makeSpecialFileWith(SpecialAddRequest $request) /** * 保存需要更新的专辑设置封面. - * @param SpecialAddRequest $request [description] + * + * @param SpecialAddRequest $request [description] * @return [type] [description] */ protected function updateSpecialFileWith(SpecialUpdateRequest $request) @@ -481,9 +501,10 @@ protected function updateSpecialFileWith(SpecialUpdateRequest $request) /** * 保存歌曲使用. * - * @param array $fileWiths - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param array $fileWiths + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return void + * * @author Seven Du */ protected function saveMusicFileWith($fileWith, Music $music) @@ -495,8 +516,9 @@ protected function saveMusicFileWith($fileWith, Music $music) /** * 保存专辑封面. + * * @param [type] $fileWith [description] - * @param MusicSpecial $special [description] + * @param MusicSpecial $special [description] * @return [type] [description] */ protected function saveSpecialFileWith($fileWith, MusicSpecial $special) @@ -509,9 +531,10 @@ protected function saveSpecialFileWith($fileWith, MusicSpecial $special) /** * 保存分享文件付费节点. * - * @param array $nodes - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed + * @param array $nodes + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\Feed $feed * @return void + * * @author Seven Du */ protected function saveMusicPaidNode($nodes, Music $music) @@ -528,8 +551,9 @@ protected function saveMusicPaidNode($nodes, Music $music) /** * 保存专辑收费节点. + * * @param $node - * @param MusicSpecial $special + * @param MusicSpecial $special * @return void */ protected function saveSpecialPaidNode($node, MusicSpecial $special) diff --git a/packages/slimkit-plus-music/src/Admin/MusicStorageController.php b/packages/slimkit-plus-music/src/Admin/MusicStorageController.php index 08e8b33ab..135ab4b02 100644 --- a/packages/slimkit-plus-music/src/Admin/MusicStorageController.php +++ b/packages/slimkit-plus-music/src/Admin/MusicStorageController.php @@ -63,10 +63,11 @@ public function store(MusicUploadFileRequest $request, ResponseContract $respons /** * Validate and return the file database model instance. * - * @param \Zhiyi\Plus\Models\File $fileModel - * @param \Illuminate\Http\UploadedFile $file - * @param callable $call + * @param \Zhiyi\Plus\Models\File $fileModel + * @param \Illuminate\Http\UploadedFile $file + * @param callable $call * @return \Zhiyi\Plus\Models\File + * * @author Seven Du */ protected function validateFileInDatabase(FileModel $fileModel, UploadedFile $file, callable $call): FileModel @@ -81,10 +82,11 @@ protected function validateFileInDatabase(FileModel $fileModel, UploadedFile $fi /** * 解决数据模型非实例. * - * @param \Zhiyi\Plus\Models\FileWith $fileWith - * @param \Zhiyi\Plus\Models\User $user - * @param \Zhiyi\Plus\Models\File $file + * @param \Zhiyi\Plus\Models\FileWith $fileWith + * @param \Zhiyi\Plus\Models\User $user + * @param \Zhiyi\Plus\Models\File $file * @return \Zhiyi\Plus\Models\FileWith + * * @author Seven Du */ protected function resolveFileWith(FileWithModel $fileWith, UserModel $user, FileModel $file): FileWithModel @@ -106,11 +108,12 @@ protected function resolveFileWith(FileWithModel $fileWith, UserModel $user, Fil /** * 专辑/歌手附件上传. - * @param SpecialUploadFileRequest $request [description] - * @param ResponseContract $response [description] - * @param Carbon $dateTime [description] - * @param FileModel $fileModel [description] - * @param FileWithModel $fileWith [description] + * + * @param SpecialUploadFileRequest $request [description] + * @param ResponseContract $response [description] + * @param Carbon $dateTime [description] + * @param FileModel $fileModel [description] + * @param FileWithModel $fileWith [description] * @return [type] [description] */ public function specialStorage(SpecialUploadFileRequest $request, ResponseContract $response, Carbon $dateTime, FileModel $fileModel, FileWithModel $fileWith) diff --git a/packages/slimkit-plus-music/src/Admin/SingerController.php b/packages/slimkit-plus-music/src/Admin/SingerController.php index bd3168228..426044d6f 100644 --- a/packages/slimkit-plus-music/src/Admin/SingerController.php +++ b/packages/slimkit-plus-music/src/Admin/SingerController.php @@ -34,6 +34,7 @@ class SingerController extends Controller { /** * 歌手列表. + * * @param Request $request * @param MusicSingerModel $musicSinger * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View @@ -90,8 +91,9 @@ protected function search(MusicSinger $musicSinger, string $type, $name, $limit) /** * 恢复被禁用的用户. - * @param int $singer - * @param MusicSingerModel $singerModel + * + * @param int $singer + * @param MusicSingerModel $singerModel * @return \Illuminate\Http\RedirectResponse */ public function restore(int $singer, MusicSingerModel $singerModel) @@ -108,11 +110,12 @@ public function restore(int $singer, MusicSingerModel $singerModel) /** * 格式化歌手封面图. - * @param CdnUrlManager $cdn - * @param FileWithModel $fileWith - * @param int|int $width - * @param int|int $height - * @param int|int $quality + * + * @param CdnUrlManager $cdn + * @param FileWithModel $fileWith + * @param int|int $width + * @param int|int $height + * @param int|int $quality * @return string */ public function showCover(CdnUrlManager $cdn, FileWithModel $fileWith, int $width = 200, int $height = 200, int $quality = 60) @@ -139,8 +142,9 @@ public function add() /** * 添加歌手. - * @param SingerAddRequest $request - * @param MusicSingerModel $singer + * + * @param SingerAddRequest $request + * @param MusicSingerModel $singer * @return \Illuminate\Http\RedirectResponse */ public function store(SingerAddRequest $request, MusicSingerModel $singer) @@ -160,9 +164,10 @@ public function store(SingerAddRequest $request, MusicSingerModel $singer) /** * 歌手详情，用于编辑歌手. - * @param MusicSingerModel $singer [description] - * @param FileWithModel $fileWith - * @param CdnUrlManager $cdn + * + * @param MusicSingerModel $singer [description] + * @param FileWithModel $fileWith + * @param CdnUrlManager $cdn * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View */ public function detail(MusicSingerModel $singer, FileWithModel $fileWith, CdnUrlManager $cdn) @@ -180,8 +185,10 @@ public function detail(MusicSingerModel $singer, FileWithModel $fileWith, CdnUrl /** * 禁用歌手. - * @param MusicSingerModel $singer + * + * @param MusicSingerModel $singer * @return \Illuminate\Http\RedirectResponse + * * @throws \Exception */ public function disabled(MusicSingerModel $singer) @@ -228,7 +235,8 @@ public function update(SingerUpdateRequest $request, MusicSingerModel $singer, F /** * 添加歌手设置封面. - * @param SingerAddRequest $request [description] + * + * @param SingerAddRequest $request [description] * @return FileWithModel */ protected function makeFileWith(SingerAddRequest $request) @@ -244,7 +252,8 @@ protected function makeFileWith(SingerAddRequest $request) /** * 保存需要更新的歌手设置封面. - * @param SingerUpdateRequest $request [description] + * + * @param SingerUpdateRequest $request [description] * @return FileWithModel */ protected function updateFileWith(SingerUpdateRequest $request) @@ -260,8 +269,9 @@ protected function updateFileWith(SingerUpdateRequest $request) /** * 保存专辑封面. + * * @param [type] $fileWith [description] - * @param MusicSingerModel $singer [description] + * @param MusicSingerModel $singer [description] * @return void */ protected function saveFileWith($fileWith, MusicSingerModel $singer) diff --git a/packages/slimkit-plus-music/src/Models/MusicSpecial.php b/packages/slimkit-plus-music/src/Models/MusicSpecial.php index 34319eb34..8926ae5ef 100644 --- a/packages/slimkit-plus-music/src/Models/MusicSpecial.php +++ b/packages/slimkit-plus-music/src/Models/MusicSpecial.php @@ -74,7 +74,8 @@ public function paidNode() * 处理付费节点信息. * * @author bs<414606094@qq.com> - * @param int $user [description] + * + * @param int $user [description] * @return mix */ public function formatPaidNode(int $user) @@ -96,6 +97,7 @@ public function formatPaidNode(int $user) * 验证某个用户是否收藏了某个专辑. * * @author bs<414606094@qq.com> + * * @param [int] $user * @return bool */ diff --git a/packages/slimkit-plus-music/src/Models/Relations/MusicHasLike.php b/packages/slimkit-plus-music/src/Models/Relations/MusicHasLike.php index 61059442c..848475c74 100644 --- a/packages/slimkit-plus-music/src/Models/Relations/MusicHasLike.php +++ b/packages/slimkit-plus-music/src/Models/Relations/MusicHasLike.php @@ -30,6 +30,7 @@ trait MusicHasLike * Has likes. * * @return \Illuminate\Database\Eloquent\Relations\MorphMany + * * @author Seven Du */ public function likes() @@ -40,8 +41,9 @@ public function likes() /** * Check user like. * - * @param mixed $user + * @param mixed $user * @return bool + * * @author Seven Du */ public function liked($user): bool @@ -67,8 +69,9 @@ public function liked($user): bool /** * Like feed. * - * @param mixed $user + * @param mixed $user * @return mixed + * * @author Seven Du */ public function like($user) @@ -89,8 +92,9 @@ public function like($user) /** * Unlike feed. * - * @param mixed $user + * @param mixed $user * @return mixed + * * @author Seven Du */ public function unlike($user) @@ -112,8 +116,9 @@ public function unlike($user) /** * Forget like cache. * - * @param mixed $user + * @param mixed $user * @return void + * * @author Seven Du */ public function forgetLike($user) diff --git a/packages/slimkit-plus-music/src/Requests/MusicAdd.php b/packages/slimkit-plus-music/src/Requests/MusicAdd.php index 71892538f..76004e212 100644 --- a/packages/slimkit-plus-music/src/Requests/MusicAdd.php +++ b/packages/slimkit-plus-music/src/Requests/MusicAdd.php @@ -64,6 +64,7 @@ public function rules() * Get the validation message that apply to the request. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/packages/slimkit-plus-music/src/Requests/MusicUploadFile.php b/packages/slimkit-plus-music/src/Requests/MusicUploadFile.php index b12573073..19592de7b 100644 --- a/packages/slimkit-plus-music/src/Requests/MusicUploadFile.php +++ b/packages/slimkit-plus-music/src/Requests/MusicUploadFile.php @@ -50,6 +50,7 @@ public function rules() * Get the validation message that apply to the request. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/packages/slimkit-plus-music/src/Requests/SpecialAdd.php b/packages/slimkit-plus-music/src/Requests/SpecialAdd.php index 989f92b4d..bb2515a5f 100644 --- a/packages/slimkit-plus-music/src/Requests/SpecialAdd.php +++ b/packages/slimkit-plus-music/src/Requests/SpecialAdd.php @@ -61,6 +61,7 @@ public function rules() * Get the validation message that apply to the request. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/packages/slimkit-plus-music/src/Requests/SpecialUpdate.php b/packages/slimkit-plus-music/src/Requests/SpecialUpdate.php index c1a7818a2..e81bc07a0 100644 --- a/packages/slimkit-plus-music/src/Requests/SpecialUpdate.php +++ b/packages/slimkit-plus-music/src/Requests/SpecialUpdate.php @@ -54,6 +54,7 @@ public function rules() * Get the validation message that apply to the request. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/packages/slimkit-plus-music/src/Requests/SpecialUploadFile.php b/packages/slimkit-plus-music/src/Requests/SpecialUploadFile.php index 20305ad6b..6e8f32dbc 100644 --- a/packages/slimkit-plus-music/src/Requests/SpecialUploadFile.php +++ b/packages/slimkit-plus-music/src/Requests/SpecialUploadFile.php @@ -50,6 +50,7 @@ public function rules() * Get the validation message that apply to the request. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/packages/slimkit-plus-music/src/helpers.php b/packages/slimkit-plus-music/src/helpers.php index 3c027f0ba..8cc2b8f52 100644 --- a/packages/slimkit-plus-music/src/helpers.php +++ b/packages/slimkit-plus-music/src/helpers.php @@ -25,9 +25,10 @@ /** * Generate an asset path for the application. * - * @param string $path - * @param bool $secure + * @param string $path + * @param bool $secure * @return string + * * @author Seven Du * @homepage http://medz.cn */ @@ -41,8 +42,9 @@ function asset($path, $secure = null) /** * Get The component resource asset path. * - * @param string $path + * @param string $path * @return string + * * @author Seven Du * @homepage http://medz.cn */ @@ -54,8 +56,9 @@ function asset_path($path) /** * Get the component base path. * - * @param string $path + * @param string $path * @return string + * * @author Seven Du * @homepage http://medz.cn */ @@ -68,6 +71,7 @@ function base_path($path = '') * Get the component name. * * @return string + * * @author Seven Du * @homepage http://medz.cn */ @@ -80,6 +84,7 @@ function component_name() * Get the component route filename. * * @return string + * * @author Seven Du * @homepage http://medz.cn */ @@ -92,6 +97,7 @@ function route_path() * Get the component resource path. * * @return string + * * @author Seven Du * @homepage http://medz.cn */ @@ -104,8 +110,8 @@ function resource_path() * Get the evaluated view contents for the given view. * * @param string $view - * @param array $data - * @param array $mergeData + * @param array $data + * @param array $mergeData * @return \Illuminate\View\View|\Illuminate\Contracts\View\Factory * * @author Seven Du diff --git a/packages/slimkit-plus-news/database/seeds/AdvertisingSpaceTableSeeder.php b/packages/slimkit-plus-news/database/seeds/AdvertisingSpaceTableSeeder.php index 50a6fb9bd..e07478ace 100644 --- a/packages/slimkit-plus-news/database/seeds/AdvertisingSpaceTableSeeder.php +++ b/packages/slimkit-plus-news/database/seeds/AdvertisingSpaceTableSeeder.php @@ -29,6 +29,7 @@ class AdvertisingSpaceTableSeeder extends Seeder * Run the ad seeder. * * @return void + * * @author Seven Du */ public function run() diff --git a/packages/slimkit-plus-news/database/seeds/DatabaseSeeder.php b/packages/slimkit-plus-news/database/seeds/DatabaseSeeder.php index fd70167fe..f2d24ffa7 100644 --- a/packages/slimkit-plus-news/database/seeds/DatabaseSeeder.php +++ b/packages/slimkit-plus-news/database/seeds/DatabaseSeeder.php @@ -28,6 +28,7 @@ class DatabaseSeeder extends Seeder * Run the package seeder. * * @return void + * * @author Seven Du */ public function run() diff --git a/packages/slimkit-plus-news/database/seeds/NewsCatesTableSeeder.php b/packages/slimkit-plus-news/database/seeds/NewsCatesTableSeeder.php index 0107118ce..bed29553d 100644 --- a/packages/slimkit-plus-news/database/seeds/NewsCatesTableSeeder.php +++ b/packages/slimkit-plus-news/database/seeds/NewsCatesTableSeeder.php @@ -29,6 +29,7 @@ class NewsCatesTableSeeder extends Seeder * Run the package seeder. * * @return void + * * @author Seven Du */ public function run() diff --git a/packages/slimkit-plus-news/src/API2/Controllers/AverageController.php b/packages/slimkit-plus-news/src/API2/Controllers/AverageController.php index 7cb9b98c7..e8eaf008a 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/AverageController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/AverageController.php @@ -28,10 +28,10 @@ class AverageController extends Controller { /** - * @param Request $request - * @param Carbon $date - * @param FeedPinned $pinned - * @param ResponseContract $response + * @param Request $request + * @param Carbon $date + * @param FeedPinned $pinned + * @param ResponseContract $response * @return object */ public function show(Carbon $date, NewsPinned $pinned, ResponseContract $response) diff --git a/packages/slimkit-plus-news/src/API2/Controllers/CateController.php b/packages/slimkit-plus-news/src/API2/Controllers/CateController.php index 1c03679fe..9569e01c0 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/CateController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/CateController.php @@ -29,7 +29,8 @@ class CateController extends Controller { /** * 分类列表. - * @param $cate_id [分类ID] + * + * @param $cate_id [分类ID] * @return mixed 返回结果 */ public function list(Request $request) @@ -61,7 +62,8 @@ public function list(Request $request) /** * Follow news cate. - * @param $follows [分类字符串] + * + * @param $follows [分类字符串] * @return mixed 返回结果 */ public function follow(Request $request, NewsCateFollow $followModel) diff --git a/packages/slimkit-plus-news/src/API2/Controllers/CollectionController.php b/packages/slimkit-plus-news/src/API2/Controllers/CollectionController.php index 3b476d946..9472d10c4 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/CollectionController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/CollectionController.php @@ -30,8 +30,9 @@ class CollectionController extends Controller * 收藏资讯. * * @author bs<414606094@qq.com> - * @param Request $request - * @param News $news + * + * @param Request $request + * @param News $news * @return json */ public function collection(Request $request, News $news) @@ -54,8 +55,9 @@ public function collection(Request $request, News $news) * 取消收藏资讯. * * @author bs<414606094@qq.com> - * @param Request $request - * @param News $news + * + * @param Request $request + * @param News $news * @return void */ public function cancel(Request $request, News $news) @@ -75,7 +77,8 @@ public function cancel(Request $request, News $news) * 获取用户收藏资讯. * * @author bs<414606094@qq.com> - * @param Request $request + * + * @param Request $request * @return mixed */ public function index(Request $request) diff --git a/packages/slimkit-plus-news/src/API2/Controllers/CommentController.php b/packages/slimkit-plus-news/src/API2/Controllers/CommentController.php index eb5542244..6011f849e 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/CommentController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/CommentController.php @@ -38,9 +38,10 @@ class CommentController extends Controller * 发布资讯评论. * * @author bs<414606094@qq.com> - * @param Request $request - * @param News $news - * @param Comment $comment + * + * @param Request $request + * @param News $news + * @param Comment $comment * @return mix */ public function store(StoreNewsComment $request, News $news, Comment $comment) @@ -85,8 +86,9 @@ public function store(StoreNewsComment $request, News $news, Comment $comment) * 获取一条资讯的评论列表. * * @author bs<414606094@qq.com> - * @param Request $request - * @param news $news + * + * @param Request $request + * @param news $news * @return mix */ public function index(Request $request, news $news) @@ -116,9 +118,10 @@ public function index(Request $request, news $news) * 获取置顶的评论列表. * * @author bs<414606094@qq.com> - * @param Request $request + * + * @param Request $request * @param Carbon $dateTime - * @param News $news + * @param News $news * @return mix */ public function pinneds(Request $request, Carbon $dateTime, News $news) @@ -139,9 +142,10 @@ public function pinneds(Request $request, Carbon $dateTime, News $news) * 删除评论. * * @author bs<414606094@qq.com> - * @param Request $request - * @param news $news - * @param Comment $comment + * + * @param Request $request + * @param news $news + * @param Comment $comment * @return mix */ public function destroy(Request $request, news $news, Comment $comment, NewsPinned $pinnedModel) diff --git a/packages/slimkit-plus-news/src/API2/Controllers/CommentPinnedController.php b/packages/slimkit-plus-news/src/API2/Controllers/CommentPinnedController.php index 5195dc77e..f1afbf250 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/CommentPinnedController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/CommentPinnedController.php @@ -38,9 +38,10 @@ class CommentPinnedController extends Controller /** * 获取资讯评论当前用户审核列表. * - * @param Request $request - * @param NewsPinnedModel $model + * @param Request $request + * @param NewsPinnedModel $model * @return mixed + * * @author Seven Du */ public function index(Request $request, NewsPinnedModel $model) @@ -91,15 +92,18 @@ public function newsList(Request $request) /** * 审核评论置顶. - * @param Request $request [description] - * @param ResponseContract $response [description] - * @param Carbon $dateTime [description] - * @param WalletChargeModel $charge [description] - * @param NewsModel $news [description] - * @param CommentModel $comment [description] - * @param NewsPinnedModel $pinned [description] + * + * @param Request $request [description] + * @param ResponseContract $response [description] + * @param Carbon $dateTime [description] + * @param WalletChargeModel $charge [description] + * @param NewsModel $news [description] + * @param CommentModel $comment [description] + * @param NewsPinnedModel $pinned [description] * @return JsonResponse [type] [description] + * * @throws Throwable + * * @author Wayne < qiaobinloverabbi@gmail.com > */ public function accept( @@ -155,7 +159,9 @@ public function accept( /** * 拒绝评论置顶. + * * @author Wayne < qiaobinloverabbi@gmail.com > + * * @param Request $request [description] * @param ResponseContract $response [description] * @param Carbon $dateTime [description] @@ -224,8 +230,8 @@ public function reject( * @param NewsModel $news * @param $comment * @param NewsPinnedModel $pinned - * * @return mixed + * * @author Seven Du */ public function destroy( diff --git a/packages/slimkit-plus-news/src/API2/Controllers/ContributeController.php b/packages/slimkit-plus-news/src/API2/Controllers/ContributeController.php index 29b8e1cbd..dfde695f2 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/ContributeController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/ContributeController.php @@ -66,9 +66,10 @@ public function __construct(ApplicationContract $app) * @param Request $request * @param ResponseFactoryContract $response * @param NewsModel $model - * * @return mixed + * * @throws Throwable + * * @author Seven Du */ public function index(Request $request, ResponseFactoryContract $response, NewsModel $model) @@ -118,9 +119,10 @@ public function index(Request $request, ResponseFactoryContract $response, NewsM * @param NewsCateModel $category * @param NewsModel $news * @param TagModel $tagModel - * * @return mixed + * * @throws Throwable + * * @author Seven Du */ public function update( @@ -215,9 +217,10 @@ public function update( * @param ResponseFactoryContract $response * @param NewsCateModel $category * @param NewsModel $news - * * @return mixed + * * @throws Throwable + * * @author Seven Du */ public function destroy( @@ -260,9 +263,10 @@ public function destroy( * @param ResponseFactoryContract $response * @param NewsCateModel $category * @param NewsModel $news - * * @return mixed + * * @throws Throwable + * * @author Seven Du */ public function revoked( @@ -298,9 +302,10 @@ public function revoked( * @param NewsModel $news * @param NewsCateModel $category * @param TagModel $tagModel - * * @return mixed + * * @throws Throwable + * * @author BS <414606094@qq.com> */ public function newStore( diff --git a/packages/slimkit-plus-news/src/API2/Controllers/LikeController.php b/packages/slimkit-plus-news/src/API2/Controllers/LikeController.php index 4d5748dd9..43c509e22 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/LikeController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/LikeController.php @@ -31,8 +31,9 @@ class LikeController extends Controller * 点赞一个资讯. * * @author bs<414606094@qq.com> - * @param Request $request [description] - * @param int $news_id [description] + * + * @param Request $request [description] + * @param int $news_id [description] * @return [type] [description] */ public function like(Request $request, News $news) @@ -57,8 +58,9 @@ public function like(Request $request, News $news) * 取消点赞一个资讯. * * @author bs<414606094@qq.com> - * @param Request $request [description] - * @param int $news_id [description] + * + * @param Request $request [description] + * @param int $news_id [description] * @return [type] [description] */ public function cancel(Request $request, News $news) @@ -80,8 +82,9 @@ public function cancel(Request $request, News $news) * 一条资讯的点赞列表. * * @author bs<414606094@qq.com> - * @param Request $request - * @param News $news + * + * @param Request $request + * @param News $news * @return mix */ public function index(Request $request, News $news) diff --git a/packages/slimkit-plus-news/src/API2/Controllers/NewCommentPinnedController.php b/packages/slimkit-plus-news/src/API2/Controllers/NewCommentPinnedController.php index 218ab3f7f..f5b77e2c8 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/NewCommentPinnedController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/NewCommentPinnedController.php @@ -42,9 +42,10 @@ class NewCommentPinnedController extends Controller * @param NewsModel $news * @param CommentModel $comment * @param NewsPinnedModel $pinned - * * @return mixed + * * @throws \Exception + * * @author BS <414606094@qq.com> */ public function accept( @@ -99,9 +100,10 @@ public function accept( * @param NewsPinnedModel $pinned * @param ResponseContract $response * @param Carbon $dateTime - * * @return mixed + * * @throws \Exception + * * @author BS <414606094@qq.com> */ public function reject( diff --git a/packages/slimkit-plus-news/src/API2/Controllers/NewPinnedController.php b/packages/slimkit-plus-news/src/API2/Controllers/NewPinnedController.php index aee63b831..2a8fae785 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/NewPinnedController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/NewPinnedController.php @@ -45,10 +45,11 @@ public function __construct() /** * 申请资讯置顶. * - * @param Request $request - * @param NewsModel $news - * @param Carbon $dateTime + * @param Request $request + * @param NewsModel $news + * @param Carbon $dateTime * @return mixed + * * @author BS <414606094@qq.com> */ public function newsPinned(Request $request, NewsModel $news, Carbon $dateTime) @@ -112,11 +113,12 @@ public function newsPinned(Request $request, NewsModel $news, Carbon $dateTime) /** * 申请资讯评论置顶. * - * @param Request $request - * @param NewsModel $news - * @param CommentModel $comment - * @param Carbon $dateTime + * @param Request $request + * @param NewsModel $news + * @param CommentModel $comment + * @param Carbon $dateTime * @return mixed + * * @author BS <414606094@qq.com> */ public function commentPinned(Request $request, NewsModel $news, CommentModel $comment, Carbon $dateTime) @@ -208,9 +210,10 @@ public function commentPinned(Request $request, NewsModel $news, CommentModel $c /** * check Request. * - * @param Request $request - * @param NewsPinnedModel $pinned - * @param callable $call + * @param Request $request + * @param NewsPinnedModel $pinned + * @param callable $call + * * @author BS <414606094@qq.com> */ public function PinnedValidate(Request $request, NewsPinnedModel $pinned, callable $call) diff --git a/packages/slimkit-plus-news/src/API2/Controllers/NewRewardController.php b/packages/slimkit-plus-news/src/API2/Controllers/NewRewardController.php index 90d94df89..995d386a3 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/NewRewardController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/NewRewardController.php @@ -52,9 +52,10 @@ public function __construct() * @param Request $request * @param News $news * @param UserProcess $processer - * * @return mix + * * @throws \Exception + * * @author bs<414606094@qq.com> */ public function reward(Request $request, News $news, UserProcess $processer) diff --git a/packages/slimkit-plus-news/src/API2/Controllers/NewsController.php b/packages/slimkit-plus-news/src/API2/Controllers/NewsController.php index 7ee4f3bdd..4e78e63d3 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/NewsController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/NewsController.php @@ -30,9 +30,11 @@ class NewsController extends Controller * 获取资讯列表. * * @author bs<414606094@qq.com> - * @param Request $request - * @param News $newsModel + * + * @param Request $request + * @param News $newsModel * @return json + * * @throws \Throwable */ public function index(Request $request, News $newsModel) @@ -86,10 +88,12 @@ public function index(Request $request, News $newsModel) * 获取一个分类的置顶资讯. * * @author bs<414606094@qq.com> - * @param Request $request - * @param News $newsModel + * + * @param Request $request + * @param News $newsModel * @param Carbon $datetime * @return json + * * @throws \Throwable */ public function pinned(Request $request, News $newsModel, Carbon $datetime) @@ -121,10 +125,12 @@ public function pinned(Request $request, News $newsModel, Carbon $datetime) * Get single news info. * * @author bs<414606094@qq.com> - * @param Request $request - * @param News $news - * @param Carbon $datetime + * + * @param Request $request + * @param News $news + * @param Carbon $datetime * @return json + * * @throws \Throwable */ public function detail(Request $request, News $news, Carbon $datetime) @@ -153,9 +159,11 @@ public function detail(Request $request, News $news, Carbon $datetime) * Get correlation news from single news by tags. * * @author bs<414606094@qq.com> - * @param Request $request - * @param News $news + * + * @param Request $request + * @param News $news * @return json + * * @throws \Throwable */ public function correlation(Request $request, News $news) diff --git a/packages/slimkit-plus-news/src/API2/Controllers/PinnedController.php b/packages/slimkit-plus-news/src/API2/Controllers/PinnedController.php index 7e633c50e..d13299f72 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/PinnedController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/PinnedController.php @@ -43,7 +43,8 @@ class PinnedController extends Controller /** * Create the controller instance. * - * @param \Illuminate\Contracts\Foundation\Application $app + * @param \Illuminate\Contracts\Foundation\Application $app + * * @author Seven Du */ public function __construct(ApplicationContract $app) @@ -53,7 +54,9 @@ public function __construct(ApplicationContract $app) /** * ask for top the comment. + * * @author Wayne < qiaobinloverabbi@gmail.com > + * * @param Request $request [description] * @param NewsModel $news [description] * @param CommentModel $comment [description] @@ -114,7 +117,9 @@ public function newsPinned(Request $request, NewsModel $news, Carbon $dateTime) /** * ask for top the comment. + * * @author Wayne < qiaobinloverabbi@gmail.com > + * * @param Request $request [description] * @param NewsModel $news [description] * @param CommentModel $comment [description] @@ -208,11 +213,12 @@ public function commentPinned(Request $request, NewsModel $news, CommentModel $c /** * 保存所有数据库记录. * - * @param \Illuminate\Http\Request $request - * @param \Illuminate\Contracts\Routing\ResponseFactory $response - * @param \Zhiyi\Plus\Models\WalletCharge $charge - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned + * @param \Illuminate\Http\Request $request + * @param \Illuminate\Contracts\Routing\ResponseFactory $response + * @param \Zhiyi\Plus\Models\WalletCharge $charge + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentFeed\Models\FeedPinned $pinned * @return mixed + * * @author Seven Du */ public function save( @@ -243,7 +249,9 @@ public function save( /** * check request. + * * @author Wayne < qiaobinloverabbi@gmail.com > + * * @param Request $request [description] * @param NewsPinnedModel $pinned [description] * @param callable $call [description] diff --git a/packages/slimkit-plus-news/src/API2/Controllers/RankController.php b/packages/slimkit-plus-news/src/API2/Controllers/RankController.php index 99e78e63e..101ad79bd 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/RankController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/RankController.php @@ -31,10 +31,11 @@ class RankController extends Controller * 获取资讯排行. * * @author bs<414606094@qq.com> - * @param Illuminate\Http\Request $request - * @param Zhiyi\Component\ZhiyiPlus\PlusComponentNews\Models\News $newsModel + * + * @param Illuminate\Http\Request $request + * @param Zhiyi\Component\ZhiyiPlus\PlusComponentNews\Models\News $newsModel * @param Carbon\Carbon $datetime - * @return mixed + * @return mixed */ public function index(Request $request, News $newsModel, Carbon $datetime) { diff --git a/packages/slimkit-plus-news/src/API2/Controllers/ReportController.php b/packages/slimkit-plus-news/src/API2/Controllers/ReportController.php index 6bc919f61..376af1464 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/ReportController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/ReportController.php @@ -29,10 +29,11 @@ class ReportController extends Controller /** * 举报一条资讯. * - * @param Request $request - * @param NewsModel $news - * @param ReportModel $reportModel + * @param Request $request + * @param NewsModel $news + * @param ReportModel $reportModel * @return mixed + * * @author BS <414606094@qq.com> */ public function news(Request $request, NewsModel $news, ReportModel $reportModel) diff --git a/packages/slimkit-plus-news/src/API2/Controllers/RewardController.php b/packages/slimkit-plus-news/src/API2/Controllers/RewardController.php index 1de99e2a2..27e96a4bc 100644 --- a/packages/slimkit-plus-news/src/API2/Controllers/RewardController.php +++ b/packages/slimkit-plus-news/src/API2/Controllers/RewardController.php @@ -46,9 +46,10 @@ public function __construct(CommonConfig $configModel) * 打赏一条资讯. * * @author bs<414606094@qq.com> - * @param Request $request - * @param News $news - * @param WalletCharge $charge + * + * @param Request $request + * @param News $news + * @param WalletCharge $charge * @return mix */ public function reward(Request $request, News $news, WalletCharge $charge) @@ -126,8 +127,9 @@ public function reward(Request $request, News $news, WalletCharge $charge) * 一条资讯的打赏列表. * * @author bs<414606094@qq.com> - * @param Request $request - * @param News $news + * + * @param Request $request + * @param News $news * @return mix */ public function index(Request $request, News $news) @@ -158,7 +160,8 @@ public function index(Request $request, News $news) * 查看一条资讯的打赏统计 * * @author bs<414606094@qq.com> - * @param News $news + * + * @param News $news * @return array */ public function sum(News $news) diff --git a/packages/slimkit-plus-news/src/API2/Requests/StoreContribute.php b/packages/slimkit-plus-news/src/API2/Requests/StoreContribute.php index 15c4205d5..a4178c78c 100644 --- a/packages/slimkit-plus-news/src/API2/Requests/StoreContribute.php +++ b/packages/slimkit-plus-news/src/API2/Requests/StoreContribute.php @@ -30,6 +30,7 @@ class StoreContribute extends FormRequest * Store news contribute authorize. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -53,6 +54,7 @@ protected function failedAuthorization() * Get the validate rules. * * @return array + * * @author Seven Du */ public function rules(): array @@ -72,6 +74,7 @@ public function rules(): array * Get the validate messages. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/packages/slimkit-plus-news/src/API2/Requests/StoreNewsComment.php b/packages/slimkit-plus-news/src/API2/Requests/StoreNewsComment.php index 6e0d517c1..493dbbdfc 100644 --- a/packages/slimkit-plus-news/src/API2/Requests/StoreNewsComment.php +++ b/packages/slimkit-plus-news/src/API2/Requests/StoreNewsComment.php @@ -30,6 +30,7 @@ class StoreNewsComment extends FormRequest * authorization check. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -41,6 +42,7 @@ public function authorize(): bool * get the validator rules. * * @return array + * * @author Seven Du */ public function rules(): array @@ -58,6 +60,7 @@ public function rules(): array * Get the validator messages. * * @return array + * * @author Seven Du */ public function messages(): array diff --git a/packages/slimkit-plus-news/src/AdminControllers/AuthUserController.php b/packages/slimkit-plus-news/src/AdminControllers/AuthUserController.php index 977762981..73fe3cc37 100644 --- a/packages/slimkit-plus-news/src/AdminControllers/AuthUserController.php +++ b/packages/slimkit-plus-news/src/AdminControllers/AuthUserController.php @@ -47,8 +47,8 @@ public function getAuthUserList(Request $request) /** * 认证用户. * - * @param Request $request [description] - * @param int $aid [description] + * @param Request $request [description] + * @param int $aid [description] * @return [type] [description] */ public function audit(Request $request, int $aid) @@ -67,7 +67,7 @@ public function audit(Request $request, int $aid) /** * 删除用户认证信息. * - * @param int $aid [description] + * @param int $aid [description] * @return [type] [description] */ public function delAuthInfo(int $aid) diff --git a/packages/slimkit-plus-news/src/AdminControllers/NewsApplyLogController.php b/packages/slimkit-plus-news/src/AdminControllers/NewsApplyLogController.php index 745adb8e6..2a768fe38 100644 --- a/packages/slimkit-plus-news/src/AdminControllers/NewsApplyLogController.php +++ b/packages/slimkit-plus-news/src/AdminControllers/NewsApplyLogController.php @@ -33,10 +33,10 @@ class NewsApplyLogController extends Controller /** * 删除申请列表. * - * @param Request $request - * @param NewsApplyLog $model - * + * @param Request $request + * @param NewsApplyLog $model * @return mixed + * * @author BS <414606094@qq.com> */ public function index(Request $request, NewsApplyLog $model) diff --git a/packages/slimkit-plus-news/src/AdminControllers/NewsConfigController.php b/packages/slimkit-plus-news/src/AdminControllers/NewsConfigController.php index 390f28180..697501ade 100644 --- a/packages/slimkit-plus-news/src/AdminControllers/NewsConfigController.php +++ b/packages/slimkit-plus-news/src/AdminControllers/NewsConfigController.php @@ -29,6 +29,7 @@ class NewsConfigController extends Controller { /** * 查看资讯配置. + * * @return mixed */ public function show() @@ -48,8 +49,8 @@ public function show() /** * 更新投稿配置. * - * @param Request $request - * @param Configuration $configuration + * @param Request $request + * @param Configuration $configuration */ public function setContribute(Request $request) { @@ -65,8 +66,8 @@ public function setContribute(Request $request) /** * 投稿金额配置. * - * @param Request $request - * @param Configuration $configuration + * @param Request $request + * @param Configuration $configuration */ public function setPayContribute(Request $request) { diff --git a/packages/slimkit-plus-news/src/AdminControllers/NewsController.php b/packages/slimkit-plus-news/src/AdminControllers/NewsController.php index 1fcb152da..6fd2fa6a5 100644 --- a/packages/slimkit-plus-news/src/AdminControllers/NewsController.php +++ b/packages/slimkit-plus-news/src/AdminControllers/NewsController.php @@ -43,7 +43,8 @@ class NewsController extends Controller /** * 资讯列表. - * @param $cate_id [分类ID] + * + * @param $cate_id [分类ID] * @return mixed 返回结果 */ public function getNewsList(Request $request, Carbon $datetime) @@ -84,7 +85,7 @@ public function getNewsList(Request $request, Carbon $datetime) /** * 回收站资讯列表. * - * @param $cate_id [分类ID] + * @param $cate_id [分类ID] * @return mixed 返回结果 */ public function getRecycleList(Request $request) @@ -110,9 +111,10 @@ public function getRecycleList(Request $request) } /** - * @param Request $request - * @param TagModel $tagModel + * @param Request $request + * @param TagModel $tagModel * @return \Illuminate\Http\JsonResponse + * * @throws \Throwable */ public function doSaveNews(Request $request, TagModel $tagModel) diff --git a/packages/slimkit-plus-news/src/AdminControllers/NewsPinnedController.php b/packages/slimkit-plus-news/src/AdminControllers/NewsPinnedController.php index e8d0dcd09..40eeeb12b 100644 --- a/packages/slimkit-plus-news/src/AdminControllers/NewsPinnedController.php +++ b/packages/slimkit-plus-news/src/AdminControllers/NewsPinnedController.php @@ -34,8 +34,9 @@ class NewsPinnedController extends Controller * 获取置顶审核列表. * * @author bs<414606094@qq.com> - * @param Request $request - * @param NewsPinned $newsPinnedModel + * + * @param Request $request + * @param NewsPinned $newsPinnedModel * @return mixed */ public function index(Request $request, NewsPinned $newsPinnedModel) @@ -84,8 +85,9 @@ public function index(Request $request, NewsPinned $newsPinnedModel) * 审核资讯置顶. * * @author bs<414606094@qq.com> - * @param Request $request - * @param NewsPinned $pinned + * + * @param Request $request + * @param NewsPinned $pinned * @return mixed */ public function audit(Request $request, UserProcess $userProcess, NewsPinned $pinned) @@ -164,8 +166,9 @@ public function reject(UserProcess $userProcess, NewsPinned $pinned) * 后台设置置顶. * * @author bs<414606094@qq.com> - * @param Request $request - * @param News $news + * + * @param Request $request + * @param News $news * @param Carbon $datetime */ public function set(Request $request, News $news, Carbon $datetime) @@ -197,10 +200,11 @@ public function set(Request $request, News $news, Carbon $datetime) /** * 取消后台资讯. * - * @param \Illuminate\Http\Request $request - * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentNews\Models\News $news - * @param \Illuminate\Support\Carbon $datetime + * @param \Illuminate\Http\Request $request + * @param \Zhiyi\Component\ZhiyiPlus\PlusComponentNews\Models\News $news + * @param \Illuminate\Support\Carbon $datetime * @return mixed + * * @author BS <414606094@qq.com> */ public function cancel(News $news, Carbon $datetime) diff --git a/packages/slimkit-plus-news/src/Middleware/VerifyCommentContent.php b/packages/slimkit-plus-news/src/Middleware/VerifyCommentContent.php index 2ec85576d..037899bc9 100644 --- a/packages/slimkit-plus-news/src/Middleware/VerifyCommentContent.php +++ b/packages/slimkit-plus-news/src/Middleware/VerifyCommentContent.php @@ -28,9 +28,8 @@ class VerifyCommentContent /** * check the comment_content. * - * @param \Illuminate\Http\Request $request - * @param \Closure $next - * + * @param \Illuminate\Http\Request $request + * @param \Closure $next * @return mixed */ public function handle(Request $request, Closure $next) diff --git a/packages/slimkit-plus-news/src/Models/News.php b/packages/slimkit-plus-news/src/Models/News.php index 21481053f..ac5bf32d8 100644 --- a/packages/slimkit-plus-news/src/Models/News.php +++ b/packages/slimkit-plus-news/src/Models/News.php @@ -61,6 +61,7 @@ class News extends Model * Has catrgory. * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author Seven Du */ public function category() @@ -70,9 +71,11 @@ public function category() /** * black list of current user. + * * @Author Wayne * @DateTime 2018-04-14 * @Email qiaobin@zhiyicx.com + * * @return \Illuminate\Database\Eloquent\Relations\HasMany */ public function blacks() @@ -84,6 +87,7 @@ public function blacks() * Has image. * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author Seven Du */ public function image() @@ -114,6 +118,7 @@ public function comments() /** * 筛选已审核文章. + * * @param Builder $query * @return Builder */ @@ -124,7 +129,9 @@ public function scopeByAudit(Builder $query): Builder /** * 资讯拥有的置顶评论. + * * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany + * * @author Wayne < qiaobinloverabbi@gmail.com > */ public function pinnedComments() @@ -135,7 +142,9 @@ public function pinnedComments() /** * 是否置顶. + * * @return \Illuminate\Database\Eloquent\Relations\HasOne + * * @author Wayne < qiaobinloverabbi@gmail.com > */ public function pinned() @@ -148,6 +157,7 @@ public function pinned() * Has tags of the news. * * @return \Illuminate\Database\Eloquent\Relations\MorphToMany + * * @author Seven Du */ public function tags() @@ -160,6 +170,7 @@ public function tags() * 资讯关联的删除申请记录. * * @return mixed + * * @author BS <414606094@qq.com> */ public function applylog() @@ -171,6 +182,7 @@ public function applylog() * 被举报记录. * * @return morphMany + * * @author BS <414606094@qq.com> */ public function reports(): morphMany diff --git a/packages/slimkit-plus-news/src/Models/NewsCate.php b/packages/slimkit-plus-news/src/Models/NewsCate.php index 6c9cf501a..4fa896e15 100644 --- a/packages/slimkit-plus-news/src/Models/NewsCate.php +++ b/packages/slimkit-plus-news/src/Models/NewsCate.php @@ -35,6 +35,7 @@ class NewsCate extends Model * Has news. * * @return null| + * * @author Seven Du */ public function news() diff --git a/packages/slimkit-plus-news/src/Models/NewsComment.php b/packages/slimkit-plus-news/src/Models/NewsComment.php index 04b463e70..e9f53bd96 100644 --- a/packages/slimkit-plus-news/src/Models/NewsComment.php +++ b/packages/slimkit-plus-news/src/Models/NewsComment.php @@ -30,6 +30,7 @@ class NewsComment extends Model /** * 单条评论属于一条资讯. + * * @return [type] [description] */ public function news() diff --git a/packages/slimkit-plus-news/src/Models/Relations/NewsHasCollection.php b/packages/slimkit-plus-news/src/Models/Relations/NewsHasCollection.php index 26bfc7f91..e5e6e22d7 100644 --- a/packages/slimkit-plus-news/src/Models/Relations/NewsHasCollection.php +++ b/packages/slimkit-plus-news/src/Models/Relations/NewsHasCollection.php @@ -30,6 +30,7 @@ trait NewsHasCollection * 资讯收藏记录. * * @author bs<414606094@qq.com> + * * @return null|HasMany */ public function collections() @@ -41,7 +42,8 @@ public function collections() * 判断用户是否已收藏. * * @author bs<414606094@qq.com> - * @param User|int $user + * + * @param User|int $user * @return bool */ public function collected($user): bool @@ -66,7 +68,8 @@ public function collected($user): bool * 收藏操作. * * @author bs<414606094@qq.com> - * @param User|int $user + * + * @param User|int $user * @return mix */ public function collection($user) @@ -89,7 +92,8 @@ public function collection($user) * 取消收藏. * * @author bs<414606094@qq.com> - * @param User|int $user + * + * @param User|int $user * @return mix */ public function unCollection($user) diff --git a/packages/slimkit-plus-news/src/Models/Relations/NewsHasLike.php b/packages/slimkit-plus-news/src/Models/Relations/NewsHasLike.php index 2ecec22c4..bbf518112 100644 --- a/packages/slimkit-plus-news/src/Models/Relations/NewsHasLike.php +++ b/packages/slimkit-plus-news/src/Models/Relations/NewsHasLike.php @@ -30,6 +30,7 @@ trait NewsHasLike * Has likes. * * @return \Illuminate\Database\Eloquent\Relations\MorphMany + * * @author Seven Du */ public function likes() @@ -40,8 +41,9 @@ public function likes() /** * Check user like. * - * @param mixed $user + * @param mixed $user * @return bool + * * @author Seven Du */ public function liked($user): bool @@ -67,7 +69,7 @@ public function liked($user): bool /** * Like news. * - * @param mixed $user + * @param mixed $user * @return mixed */ public function like($user) @@ -90,8 +92,9 @@ public function like($user) /** * Unlike feed. * - * @param mixed $user + * @param mixed $user * @return mixed + * * @author Seven Du */ public function unlike($user) @@ -114,7 +117,7 @@ public function unlike($user) /** * Forget like cache. * - * @param mixed $user + * @param mixed $user * @return void */ public function forgetLike($user) diff --git a/packages/slimkit-plus-news/src/Models/Relations/NewsHasReward.php b/packages/slimkit-plus-news/src/Models/Relations/NewsHasReward.php index f70cbd1ec..c1c25414e 100644 --- a/packages/slimkit-plus-news/src/Models/Relations/NewsHasReward.php +++ b/packages/slimkit-plus-news/src/Models/Relations/NewsHasReward.php @@ -36,8 +36,9 @@ public function rewards() * Reward a author of news. * * @author bs<414606094@qq.com> - * @param mix $user - * @param float $amount + * + * @param mix $user + * @param float $amount * @return mix */ public function reward($user, $amount) @@ -62,6 +63,7 @@ public function reward($user, $amount) * 打赏总数统计 * * @author bs<414606094@qq.com> + * * @return mix */ public function rewardCount() diff --git a/packages/slimkit-plus-news/src/Providers/NewsServiceProvider.php b/packages/slimkit-plus-news/src/Providers/NewsServiceProvider.php index 676ec0ef9..488b65027 100644 --- a/packages/slimkit-plus-news/src/Providers/NewsServiceProvider.php +++ b/packages/slimkit-plus-news/src/Providers/NewsServiceProvider.php @@ -36,6 +36,7 @@ class NewsServiceProvider extends ServiceProvider * Bootstrap the provider. * * @return void + * * @author Seven Du */ public function boot() @@ -107,6 +108,7 @@ public function boot() * register provided to provider. * * @return void + * * @author Seven Du */ public function register() diff --git a/packages/slimkit-plus-news/src/helpers.php b/packages/slimkit-plus-news/src/helpers.php index 7577a4337..08447db5a 100644 --- a/packages/slimkit-plus-news/src/helpers.php +++ b/packages/slimkit-plus-news/src/helpers.php @@ -25,9 +25,10 @@ /** * Generate an asset path for the application. * - * @param string $path - * @param bool $secure + * @param string $path + * @param bool $secure * @return string + * * @author Seven Du * @homepage http://medz.cn */ @@ -41,8 +42,9 @@ function asset($path, $secure = null) /** * Get The component resource asset path. * - * @param string $path + * @param string $path * @return string + * * @author Seven Du * @homepage http://medz.cn */ @@ -54,8 +56,9 @@ function asset_path($path) /** * Get the component base path. * - * @param string $path + * @param string $path * @return string + * * @author Seven Du * @homepage http://medz.cn */ @@ -68,6 +71,7 @@ function base_path($path = '') * Get the component name. * * @return string + * * @author Seven Du * @homepage http://medz.cn */ @@ -80,6 +84,7 @@ function component_name() * Get the component route filename. * * @return string + * * @author Seven Du * @homepage http://medz.cn */ @@ -92,6 +97,7 @@ function route_path() * Get the component resource path. * * @return string + * * @author Seven Du * @homepage http://medz.cn */ diff --git a/packages/slimkit-plus-news/tests/Feature/API2/PinnedNewsTest.php b/packages/slimkit-plus-news/tests/Feature/API2/PinnedNewsTest.php index 3a2f95ea8..45c57fe55 100644 --- a/packages/slimkit-plus-news/tests/Feature/API2/PinnedNewsTest.php +++ b/packages/slimkit-plus-news/tests/Feature/API2/PinnedNewsTest.php @@ -54,6 +54,7 @@ public function setUp() * @Author Wayne * @DateTime 2018-04-24 * @Email qiaobin@zhiyicx.com + * * @return void [type] */ public function testNewPinnedNewsComment() diff --git a/packages/slimkit-plus-socialite/src/API/Controllers/SocialiteController.php b/packages/slimkit-plus-socialite/src/API/Controllers/SocialiteController.php index 25d6cde98..14e8c7bd1 100644 --- a/packages/slimkit-plus-socialite/src/API/Controllers/SocialiteController.php +++ b/packages/slimkit-plus-socialite/src/API/Controllers/SocialiteController.php @@ -50,7 +50,8 @@ class SocialiteController extends Controller /** * Create socialite controler. * - * @param \SlimKit\PlusSocialite\SocialiteManager $socialite + * @param \SlimKit\PlusSocialite\SocialiteManager $socialite + * * @author Seven Du */ public function __construct(SocialiteManager $socialite) @@ -61,8 +62,9 @@ public function __construct(SocialiteManager $socialite) /** * Get all providers bind status. * - * @param \Illuminate\Http\Request $request + * @param \Illuminate\Http\Request $request * @return mixed + * * @author Seven Du */ public function providersStatus(Request $request) @@ -76,9 +78,10 @@ public function providersStatus(Request $request) /** * Check bind and get user auth token. * - * @param \SlimKit\PlusSocialite\API\Requests\AccessTokenRequest $request - * @param string $provider + * @param \SlimKit\PlusSocialite\API\Requests\AccessTokenRequest $request + * @param string $provider * @return mixed + * * @author Seven Du */ public function checkAuth(AccessTokenRequest $request, string $provider) @@ -92,9 +95,10 @@ public function checkAuth(AccessTokenRequest $request, string $provider) /** * Create user and return auth token. * - * @param \SlimKit\PlusSocialite\API\Requests\CreateUserRequest $request - * @param string $provider + * @param \SlimKit\PlusSocialite\API\Requests\CreateUserRequest $request + * @param string $provider * @return mixed + * * @author Seven Du */ public function createUser(CreateUserRequest $request, string $provider) @@ -109,9 +113,10 @@ public function createUser(CreateUserRequest $request, string $provider) /** * Bind provider for account. * - * @param \SlimKit\PlusSocialite\API\Requests\AccessTokenRequest $request - * @param string $provider + * @param \SlimKit\PlusSocialite\API\Requests\AccessTokenRequest $request + * @param string $provider * @return mixed + * * @author Seven Du */ public function bindForAccount(AccessTokenRequest $request, string $provider) @@ -126,9 +131,10 @@ public function bindForAccount(AccessTokenRequest $request, string $provider) /** * Bind provider for user. * - * @param \SlimKit\PlusSocialite\API\Requests\AccessTokenRequest $request - * @param string $provider + * @param \SlimKit\PlusSocialite\API\Requests\AccessTokenRequest $request + * @param string $provider * @return mixed + * * @author Seven Du */ public function bindForUser(AccessTokenRequest $request, string $provider) @@ -142,9 +148,10 @@ public function bindForUser(AccessTokenRequest $request, string $provider) /** * Unbind provider for user. * - * @param \Illuminate\Http\Request $request - * @param string $provider + * @param \Illuminate\Http\Request $request + * @param string $provider * @return mixed + * * @author Seven Du */ public function unbindForUser(Request $request, string $provider) @@ -157,8 +164,9 @@ public function unbindForUser(Request $request, string $provider) /** * Get provider name. * - * @param string $provider + * @param string $provider * @return string + * * @author Seven Du */ protected function getProviderName(string $provider): string @@ -169,8 +177,9 @@ protected function getProviderName(string $provider): string /** * Get provider driver. * - * @param string $provider + * @param string $provider * @return \SlimKit\PlusSoacialite\Contracts\Sociable + * * @author Seven Du */ protected function provider(string $provider): Sociable diff --git a/packages/slimkit-plus-socialite/src/API/Controllers/WechatController.php b/packages/slimkit-plus-socialite/src/API/Controllers/WechatController.php index 912d3d985..ca623c1a6 100644 --- a/packages/slimkit-plus-socialite/src/API/Controllers/WechatController.php +++ b/packages/slimkit-plus-socialite/src/API/Controllers/WechatController.php @@ -28,10 +28,12 @@ class WechatController extends Controller { /** * 获取授权跳转页面, 防止appid外泄. + * * @Author Wayne * @DateTime 2018-03-19 * @Email qiaobin@zhiyicx.com - * @return [type] [description] + * + * @return [type] [description] */ public function getOauthUrl(Request $request) { @@ -51,12 +53,14 @@ public function getOauthUrl(Request $request) /** * 获取网页授权的access_token, 以及unionid. + * * @Author Wayne * @DateTime 2018-03-19 * @Email qiaobin@zhiyicx.com - * @param Request $request [description] - * @param string $code [description] - * @return [type] [description] + * + * @param Request $request [description] + * @param string $code [description] + * @return [type] [description] */ public function getAccess(string $code) { @@ -72,11 +76,13 @@ public function getAccess(string $code) /** * 获取微信用户信息. + * * @Author Wayne * @DateTime 2018-03-19 * @Email qiaobin@zhiyicx.com - * @param Request $request [description] - * @return [type] [description] + * + * @param Request $request [description] + * @return [type] [description] */ public function getUser(Request $request) { diff --git a/packages/slimkit-plus-socialite/src/API/Requests/AccessTokenRequest.php b/packages/slimkit-plus-socialite/src/API/Requests/AccessTokenRequest.php index 161cc5a04..4b7bb34ea 100644 --- a/packages/slimkit-plus-socialite/src/API/Requests/AccessTokenRequest.php +++ b/packages/slimkit-plus-socialite/src/API/Requests/AccessTokenRequest.php @@ -28,6 +28,7 @@ class AccessTokenRequest extends FormRequest * Determine if the user is authorized to make this request. * * @return bool + * * @author Seven Du */ public function authorize(): bool @@ -39,6 +40,7 @@ public function authorize(): bool * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/packages/slimkit-plus-socialite/src/API/Requests/CreateUserRequest.php b/packages/slimkit-plus-socialite/src/API/Requests/CreateUserRequest.php index 96af5f318..75762396f 100644 --- a/packages/slimkit-plus-socialite/src/API/Requests/CreateUserRequest.php +++ b/packages/slimkit-plus-socialite/src/API/Requests/CreateUserRequest.php @@ -28,6 +28,7 @@ class CreateUserRequest extends AccessTokenRequest * Get the validation rules that apply to the request. * * @return array + * * @author Seven Du */ public function rules(): array diff --git a/packages/slimkit-plus-socialite/src/Contracts/Sociable.php b/packages/slimkit-plus-socialite/src/Contracts/Sociable.php index c92402c99..2be343f85 100644 --- a/packages/slimkit-plus-socialite/src/Contracts/Sociable.php +++ b/packages/slimkit-plus-socialite/src/Contracts/Sociable.php @@ -27,8 +27,9 @@ interface Sociable /** * Check bind and get user auth token. * - * @param string $accessToken + * @param string $accessToken * @return mixed + * * @author Seven Du */ public function authUser(string $accessToken); @@ -36,9 +37,10 @@ public function authUser(string $accessToken); /** * Bind provider for user. * - * @param string $accessToken - * @param Zhiyi\Plus\Models\User $user + * @param string $accessToken + * @param Zhiyi\Plus\Models\User $user * @return mixed + * * @author Seven Du */ public function bindForUser(string $accessToken, UserModel $user); @@ -46,10 +48,11 @@ public function bindForUser(string $accessToken, UserModel $user); /** * Bind provider for account. * - * @param string $accessToken - * @param string|int $login - * @param string $password + * @param string $accessToken + * @param string|int $login + * @param string $password * @return mixed + * * @author Seven Du */ public function bindForAccount(string $accessToken, $login, string $password); @@ -57,10 +60,11 @@ public function bindForAccount(string $accessToken, $login, string $password); /** * Create user and check create attribute. * - * @param string $accessToken - * @param string $name - * @param bool $check + * @param string $accessToken + * @param string $name + * @param bool $check * @return mixed + * * @author Seven Du */ public function createUser(string $accessToken, string $name, $check = false); @@ -68,8 +72,9 @@ public function createUser(string $accessToken, string $name, $check = false); /** * Unbind provider for user. * - * @param \Zhiyi\Plus\Models\User $user + * @param \Zhiyi\Plus\Models\User $user * @return mixed + * * @author Seven Du */ public function unbindForUser(UserModel $user); diff --git a/packages/slimkit-plus-socialite/src/Drivers/DriverAbstract.php b/packages/slimkit-plus-socialite/src/Drivers/DriverAbstract.php index e8c0072fd..4c0f0da98 100644 --- a/packages/slimkit-plus-socialite/src/Drivers/DriverAbstract.php +++ b/packages/slimkit-plus-socialite/src/Drivers/DriverAbstract.php @@ -34,6 +34,7 @@ abstract class DriverAbstract implements Sociable * Get provider type. * * @return string + * * @author Seven Du */ abstract public function provider(): string; @@ -41,8 +42,9 @@ abstract public function provider(): string; /** * Get provider union ID. * - * @param string $accessToken + * @param string $accessToken * @return string + * * @author Seven Du */ abstract public function unionid(string $accessToken): string; @@ -50,8 +52,9 @@ abstract public function unionid(string $accessToken): string; /** * Check bind and get user auth token. * - * @param string $accessToken + * @param string $accessToken * @return mixed + * * @author Seven Du */ public function authUser(string $accessToken) @@ -68,9 +71,10 @@ public function authUser(string $accessToken) /** * Bind provider for user. * - * @param string $accessToken - * @param Zhiyi\Plus\Models\User $user + * @param string $accessToken + * @param Zhiyi\Plus\Models\User $user * @return mixed + * * @author Seven Du */ public function bindForUser(string $accessToken, UserModel $user) @@ -98,10 +102,11 @@ public function bindForUser(string $accessToken, UserModel $user) /** * Bind provider for account. * - * @param string $accessToken - * @param string|int $login - * @param string $password + * @param string $accessToken + * @param string|int $login + * @param string $password * @return mixed + * * @author Seven Du */ public function bindForAccount(string $accessToken, $login, string $password) @@ -132,10 +137,11 @@ public function bindForAccount(string $accessToken, $login, string $password) /** * Create user and check create attribute. * - * @param string $accessToken - * @param string $name - * @param bool $check + * @param string $accessToken + * @param string $name + * @param bool $check * @return mixed + * * @author Seven Du */ public function createUser(string $accessToken, string $name, $check = false) @@ -153,8 +159,9 @@ public function createUser(string $accessToken, string $name, $check = false) /** * Unbind provider for user. * - * @param \Zhiyi\Plus\Models\User $user + * @param \Zhiyi\Plus\Models\User $user * @return mixed + * * @author Seven Du */ public function unbindForUser(UserModel $user) diff --git a/packages/slimkit-plus-socialite/src/Drivers/QQDriver.php b/packages/slimkit-plus-socialite/src/Drivers/QQDriver.php index a54be9ec0..21d7ceea5 100644 --- a/packages/slimkit-plus-socialite/src/Drivers/QQDriver.php +++ b/packages/slimkit-plus-socialite/src/Drivers/QQDriver.php @@ -26,6 +26,7 @@ class QQDriver extends DriverAbstract * Get base URI. * * @return string + * * @author Seven Du */ protected function getBaseURI(): string @@ -37,6 +38,7 @@ protected function getBaseURI(): string * Get the provider. * * @return string + * * @author Seven Du */ public function provider(): string @@ -47,8 +49,9 @@ public function provider(): string /** * Request Tencent QQ user unionid. * - * @param string $accessToken + * @param string $accessToken * @return string + * * @author Seven Du */ public function unionid(string $accessToken): string @@ -74,8 +77,7 @@ public function unionid(string $accessToken): string /** * Remove the fucking callback parentheses. * - * @param string $response - * + * @param string $response * @return string */ protected function removeCallback(string $response): string diff --git a/packages/slimkit-plus-socialite/src/Drivers/WeChatDriver.php b/packages/slimkit-plus-socialite/src/Drivers/WeChatDriver.php index 041215e55..316348da3 100644 --- a/packages/slimkit-plus-socialite/src/Drivers/WeChatDriver.php +++ b/packages/slimkit-plus-socialite/src/Drivers/WeChatDriver.php @@ -26,6 +26,7 @@ class WeChatDriver extends DriverAbstract * Get base URI. * * @return string + * * @author Seven Du */ protected function getBaseURI(): string @@ -37,6 +38,7 @@ protected function getBaseURI(): string * Get the provider. * * @return string + * * @author Seven Du */ public function provider(): string @@ -47,8 +49,9 @@ public function provider(): string /** * Get WeChat union ID. * - * @param string $accessToken + * @param string $accessToken * @return string + * * @author Seven Du */ public function unionid(string $accessToken): string diff --git a/packages/slimkit-plus-socialite/src/Drivers/WeiboDriver.php b/packages/slimkit-plus-socialite/src/Drivers/WeiboDriver.php index db3b3ac36..6203b8b83 100644 --- a/packages/slimkit-plus-socialite/src/Drivers/WeiboDriver.php +++ b/packages/slimkit-plus-socialite/src/Drivers/WeiboDriver.php @@ -26,6 +26,7 @@ class WeiboDriver extends DriverAbstract * Get base URI. * * @return string + * * @author Seven Du */ protected function getBaseURI(): string @@ -37,6 +38,7 @@ protected function getBaseURI(): string * Get the provider. * * @return string + * * @author Seven Du */ public function provider(): string @@ -47,8 +49,9 @@ public function provider(): string /** * Get union id for Weibo. * - * @param string $accessToken + * @param string $accessToken * @return string + * * @author Seven Du */ public function unionid(string $accessToken): string diff --git a/packages/slimkit-plus-socialite/src/Models/UserSocialite.php b/packages/slimkit-plus-socialite/src/Models/UserSocialite.php index bae0c2b46..b0e9d7355 100644 --- a/packages/slimkit-plus-socialite/src/Models/UserSocialite.php +++ b/packages/slimkit-plus-socialite/src/Models/UserSocialite.php @@ -37,6 +37,7 @@ class UserSocialite extends Model * Get user. * * @return \Illuminate\Database\Eloquent\Relations\BelongsTo + * * @author Seven Du */ public function user() @@ -47,7 +48,8 @@ public function user() /** * Set type. * - * @param string $type + * @param string $type + * * @author Seven Du */ public function setTypeAttribute(string $type) @@ -58,10 +60,11 @@ public function setTypeAttribute(string $type) /** * Scope socialite provider. * - * @param \Illuminate\Database\Eloquent\Builder $query - * @param string $type - * @param string $unionid + * @param \Illuminate\Database\Eloquent\Builder $query + * @param string $type + * @param string $unionid * @return \Illuminate\Database\Eloquent\Builder + * * @author Seven Du */ public function scopeProvider(Builder $query, string $type, string $unionid) @@ -73,10 +76,11 @@ public function scopeProvider(Builder $query, string $type, string $unionid) /** * Scope socialite provider to user. * - * @param \Illuminate\Database\Eloquent\Builder $query - * @param string $type - * @param string|int $userID + * @param \Illuminate\Database\Eloquent\Builder $query + * @param string $type + * @param string|int $userID * @return \Illuminate\Database\Eloquent\Builder + * * @author Seven Du */ public function scopeProviderToUser(Builder $query, string $type, $userID) diff --git a/packages/slimkit-plus-socialite/src/Providers/ModelServiceProvider.php b/packages/slimkit-plus-socialite/src/Providers/ModelServiceProvider.php index 70b694aa0..69eaaa91e 100644 --- a/packages/slimkit-plus-socialite/src/Providers/ModelServiceProvider.php +++ b/packages/slimkit-plus-socialite/src/Providers/ModelServiceProvider.php @@ -67,8 +67,8 @@ protected function registerMorphMap() /** * Set or get the morph map for polymorphic relations. * - * @param array|null $map - * @param bool $merge + * @param array|null $map + * @param bool $merge * @return array */ protected function morphMap(array $map = null, bool $merge = true): array diff --git a/packages/slimkit-plus-socialite/src/SocialiteManager.php b/packages/slimkit-plus-socialite/src/SocialiteManager.php index 839790a55..e317281f3 100644 --- a/packages/slimkit-plus-socialite/src/SocialiteManager.php +++ b/packages/slimkit-plus-socialite/src/SocialiteManager.php @@ -28,8 +28,10 @@ class SocialiteManager extends Manager /** * Get the default driver name. * - * @throws \Exception * @return void + * + * @throws \Exception + * * @author Seven Du */ public function getDefaultDriver() @@ -41,6 +43,7 @@ public function getDefaultDriver() * Create Tencent QQ Driver. * * @return \SlimKit\PlusSocialite\Contracts\Sociable + * * @author Seven Du */ public function createQQDriver(): Sociable @@ -52,6 +55,7 @@ public function createQQDriver(): Sociable * Create Sina Weibo Driver. * * @return \SlimKit\PlusSocialite\Contracts\Sociable + * * @author Seven Du */ public function createWeiboDriver(): Sociable @@ -63,6 +67,7 @@ public function createWeiboDriver(): Sociable * Create Tencent WeChat Driver. * * @return \SlimKit\PlusSocialite\Contracts\Sociable + * * @author Seven Du */ public function createWeChatDriver(): Sociable diff --git a/packages/slimkit-plus-socialite/src/Traits/SocialiteDriverHelper.php b/packages/slimkit-plus-socialite/src/Traits/SocialiteDriverHelper.php index 8865c1366..57773987a 100644 --- a/packages/slimkit-plus-socialite/src/Traits/SocialiteDriverHelper.php +++ b/packages/slimkit-plus-socialite/src/Traits/SocialiteDriverHelper.php @@ -38,8 +38,9 @@ trait SocialiteDriverHelper /** * Get Http client. * - * @param bool $httpErrors + * @param bool $httpErrors * @return \GuzzleHttp\Client + * * @author Seven Du */ protected function getHttpClient(bool $httpErrors = false): GuzzleHttpClient @@ -62,8 +63,9 @@ protected function getHttpClient(bool $httpErrors = false): GuzzleHttpClient /** * Create User. * - * @param string $name + * @param string $name * @return \Zhiyi\Plus\Models\User + * * @author Seven Du */ protected function createUserHelper(string $name, $role): UserModel @@ -80,6 +82,7 @@ protected function createUserHelper(string $name, $role): UserModel * Get default user role. * * @return int|string + * * @author Seven Du */ protected function getDefaultUserRole() @@ -90,9 +93,10 @@ protected function getDefaultUserRole() /** * Provider bind check abort. * - * @param string $type - * @param string $unionid + * @param string $type + * @param string $unionid * @return bool + * * @author Seven Du */ protected function providerBindCheckAbort(string $type, string $unionid): bool @@ -105,10 +109,11 @@ protected function providerBindCheckAbort(string $type, string $unionid): bool /** * Provider Create user. * - * @param string $type - * @param string $unionid - * @param string $name + * @param string $type + * @param string $unionid + * @param string $name * @return mixed + * * @author Seven Du */ protected function providerStoreCreateUser(string $type, string $unionid, string $name) @@ -134,10 +139,11 @@ protected function providerStoreCreateUser(string $type, string $unionid, string /** * Throw an HttpException with the given data. * - * @param mixed $condition - * @param int|\Closure $callable - * @param string $message + * @param mixed $condition + * @param int|\Closure $callable + * @param string $message * @return void + * * @author Seven Du */ protected function abortIf($condition, $callable, string $message = '') @@ -156,8 +162,9 @@ protected function abortIf($condition, $callable, string $message = '') /** * 创建账户授权 Token. * - * @param \Zhiyi\Plus\Models\User $user + * @param \Zhiyi\Plus\Models\User $user * @return mixed + * * @author Seven Du */ protected function createAuthToken(UserModel $user) diff --git a/packages/zhiyicx-plus-pc/src/AdminControllers/ConfigController.php b/packages/zhiyicx-plus-pc/src/AdminControllers/ConfigController.php index 0eaeb8650..14440c915 100644 --- a/packages/zhiyicx-plus-pc/src/AdminControllers/ConfigController.php +++ b/packages/zhiyicx-plus-pc/src/AdminControllers/ConfigController.php @@ -29,8 +29,10 @@ class ConfigController extends Controller { /** * 导航配置列表. + * * @author 28youth - * @param int|int $pos 0-顶部 1-底部 + * + * @param int|int $pos 0-顶部 1-底部 * @return mixed */ public function index(int $pos = 0) @@ -63,8 +65,10 @@ public function index(int $pos = 0) /** * 添加编辑导航. + * * @author 28youth - * @param Request $request + * + * @param Request $request * @return mixed */ public function manage(Request $request) @@ -115,8 +119,10 @@ public function manage(Request $request) /** * 获取一条导航记录. + * * @author 28youth - * @param int $nid 记录id + * + * @param int $nid 记录id * @return mixed */ public function getnav(int $nid) @@ -129,8 +135,10 @@ public function getnav(int $nid) /** * 删除导航记录. + * * @author 28youth - * @param int $nid 记录id + * + * @param int $nid 记录id * @return mixed */ public function delete(int $nid) @@ -147,9 +155,11 @@ public function delete(int $nid) /** * 获取pc基础配置信息. + * * @author 28youth - * @param Repository $config - * @param Configuration $configuration + * + * @param Repository $config + * @param Configuration $configuration * @return \Illuminate\Http\JsonResponse */ public function get(Repository $config, Configuration $configuration) @@ -165,9 +175,11 @@ public function get(Repository $config, Configuration $configuration) /** * 初始化站点设置. + * * @author 28youth - * @param Repository $config - * @param Configuration $configuration + * + * @param Repository $config + * @param Configuration $configuration * @return mixed */ private function initSiteConfiguration(Configuration $configuration) @@ -194,9 +206,11 @@ private function initSiteConfiguration(Configuration $configuration) /** * 更新pc站基本配置信息. + * * @author 28youth - * @param Request $request - * @param Configuration $configuration + * + * @param Request $request + * @param Configuration $configuration * @return mixed */ public function updateSiteInfo(Request $request, Configuration $configuration) diff --git a/packages/zhiyicx-plus-pc/src/AdminControllers/HomeController.php b/packages/zhiyicx-plus-pc/src/AdminControllers/HomeController.php index f43f49d3d..b38364da2 100644 --- a/packages/zhiyicx-plus-pc/src/AdminControllers/HomeController.php +++ b/packages/zhiyicx-plus-pc/src/AdminControllers/HomeController.php @@ -32,8 +32,10 @@ class HomeController extends Controller /** * pc后台首页. + * * @author 28youth - * @param Request $request + * + * @param Request $request * @return mixed */ public function show(Request $request, JWTAuthToken $jwt) @@ -55,7 +57,9 @@ public function show(Request $request, JWTAuthToken $jwt) /** * 菜单. + * * @author 28youth + * * @return array */ protected function menus() diff --git a/packages/zhiyicx-plus-pc/src/Controllers/AccountController.php b/packages/zhiyicx-plus-pc/src/Controllers/AccountController.php index 47cecdb56..e87d89a68 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/AccountController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/AccountController.php @@ -25,7 +25,9 @@ class AccountController extends BaseController { /** * 基本设置. + * * @author Foreach + * * @return mixed */ public function index() @@ -40,7 +42,9 @@ public function index() /** * 认证 + * * @author 28youth + * * @return mixed */ public function authenticate() @@ -58,7 +62,9 @@ public function authenticate() /** * 更新认证 + * * @author 28youth + * * @return mixed */ public function updateAuthenticate() @@ -74,7 +80,9 @@ public function updateAuthenticate() /** * 标签管理. + * * @author 28youth + * * @return mixed */ public function tags() @@ -88,7 +96,9 @@ public function tags() /** * 密码修改. + * * @author 28youth + * * @return mixed */ public function security() @@ -102,8 +112,10 @@ public function security() /** * 我的钱包. + * * @author Foreach - * @param int|int $type [类型] + * + * @param int|int $type [类型] * @return mixed */ public function wallet(int $type = 1) @@ -119,8 +131,10 @@ public function wallet(int $type = 1) /** * 钱包记录列表. + * * @author Foreach - * @param Request $request + * + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function records(Request $request) @@ -162,7 +176,9 @@ public function records(Request $request) /** * 充值 + * * @author Foreach + * * @return mixed */ public function pay() @@ -175,8 +191,10 @@ public function pay() /** * ping++充值调起. + * * @author Foreach - * @param Request $request + * + * @param Request $request * @return mixed */ public function gateway(Request $request) @@ -188,7 +206,9 @@ public function gateway(Request $request) /** * 提现. + * * @author Foreach + * * @return mixed */ public function draw() @@ -200,7 +220,9 @@ public function draw() /** * 获取绑定信息. + * * @author ZsyD + * * @return mixed */ public function getMyBinds() @@ -231,8 +253,10 @@ public function getMyBinds() /** * 我的积分. + * * @author szlvincent - * @param int|int $type [类型] + * + * @param int|int $type [类型] * @return mixed */ public function currency(int $type = 1) @@ -247,8 +271,10 @@ public function currency(int $type = 1) /** * 积分记录列表. + * * @author szlvincent - * @param Request $request + * + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function currencyRecords(Request $request) @@ -298,7 +324,9 @@ public function currencyRecords(Request $request) /** * 积分充值 + * * @author szlvincent + * * @return mixed */ public function currencyPay() @@ -312,7 +340,9 @@ public function currencyPay() /** * 积分提取. + * * @author szlvincent + * * @return mixed */ public function currencyDraw() diff --git a/packages/zhiyicx-plus-pc/src/Controllers/BaseController.php b/packages/zhiyicx-plus-pc/src/Controllers/BaseController.php index 2ee6413fc..0de50e47f 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/BaseController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/BaseController.php @@ -74,8 +74,10 @@ public function __construct() /** * 操作提示. - * @param Request $request + * + * @param Request $request * @return mixed + * * @author ZsyD */ public function notice(Request $request) @@ -92,8 +94,9 @@ public function notice(Request $request) /** * 查看资源页面. * - * @param Request $request + * @param Request $request * @return mixed + * * @author BS <414606094@qq.com> */ public function reportView(Request $request) diff --git a/packages/zhiyicx-plus-pc/src/Controllers/FeedController.php b/packages/zhiyicx-plus-pc/src/Controllers/FeedController.php index 82ec623aa..652112220 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/FeedController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/FeedController.php @@ -30,10 +30,13 @@ class FeedController extends BaseController { /** * 动态首页/列表. - * @param Request $request + * + * @param Request $request * @return mixed + * * @throws Throwable * @throws \GuzzleHttp\Exception\GuzzleException + * * @author Foreach */ public function feeds(Request $request) @@ -115,9 +118,12 @@ public function feeds(Request $request) /** * 动态详情. - * @param Feed $feed + * + * @param Feed $feed * @return mixed + * * @throws \GuzzleHttp\Exception\GuzzleException + * * @author Foreach */ public function read(Feed $feed) @@ -135,11 +141,14 @@ public function read(Feed $feed) /** * 动态评论列表. - * @param Request $request - * @param int $feed_id [动态id] + * + * @param Request $request + * @param int $feed_id [动态id] * @return JsonResponse + * * @throws Throwable * @throws \GuzzleHttp\Exception\GuzzleException + * * @author Foreach */ public function comments(Request $request, int $feed_id) diff --git a/packages/zhiyicx-plus-pc/src/Controllers/GroupController.php b/packages/zhiyicx-plus-pc/src/Controllers/GroupController.php index 543483123..90493545f 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/GroupController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/GroupController.php @@ -25,8 +25,10 @@ class GroupController extends BaseController { /** * 圈子首页. + * * @author 28youth - * @param Request $request + * + * @param Request $request * @return mixed */ public function index(Request $request) @@ -44,8 +46,10 @@ public function index(Request $request) /** * 圈子列表. + * * @author 28youth - * @param Request $request + * + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function list(Request $request) diff --git a/packages/zhiyicx-plus-pc/src/Controllers/MessageController.php b/packages/zhiyicx-plus-pc/src/Controllers/MessageController.php index 8a4da2796..2237a5a3b 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/MessageController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/MessageController.php @@ -39,8 +39,8 @@ public function index(Request $request) * 评论消息列表. * * @param Request $request - * * @return JsonResponse + * * @throws Throwable */ public function comments(Request $request) @@ -161,8 +161,8 @@ public function comments(Request $request) * 点赞消息列表. * * @param Request $request - * * @return JsonResponse + * * @throws Throwable */ public function likes(Request $request) @@ -259,8 +259,8 @@ public function likes(Request $request) * 通知消息列表. * * @param Request $request - * * @return JsonResponse + * * @throws Throwable */ public function notifications(Request $request) @@ -290,8 +290,8 @@ public function notifications(Request $request) * 动态评论置顶. * * @param Request $request - * * @return JsonResponse + * * @throws Throwable */ public function pinnedFeedComment(Request $request) @@ -316,8 +316,8 @@ public function pinnedFeedComment(Request $request) * 文章评论置顶. * * @param Request $request - * * @return JsonResponse + * * @throws Throwable */ public function pinnedNewsComment(Request $request) @@ -341,8 +341,8 @@ public function pinnedNewsComment(Request $request) * 帖子评论置顶. * * @param Request $request - * * @return JsonResponse + * * @throws Throwable */ public function pinnedPostComment(Request $request) @@ -366,8 +366,8 @@ public function pinnedPostComment(Request $request) * 圈子帖子置顶. * * @param Request $request - * * @return JsonResponse + * * @throws Throwable */ public function pinnedPost(Request $request) @@ -391,8 +391,8 @@ public function pinnedPost(Request $request) * 联系人. * * @param Request $request - * * @return JsonResponse + * * @throws Throwable */ public function followMutual(Request $request) @@ -416,8 +416,8 @@ public function followMutual(Request $request) * at 我的. * * @param Request $request - * * @return JsonResponse + * * @throws Throwable */ public function mention(Request $request) diff --git a/packages/zhiyicx-plus-pc/src/Controllers/NewsController.php b/packages/zhiyicx-plus-pc/src/Controllers/NewsController.php index eb7658a30..8ed467f58 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/NewsController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/NewsController.php @@ -27,9 +27,12 @@ class NewsController extends BaseController { /** * 资讯首页. - * @param Request $request + * + * @param Request $request * @return mixed + * * @throws \Throwable + * * @author Foreach */ public function index(Request $request) @@ -79,8 +82,10 @@ public function index(Request $request) /** * 资讯详情. - * @param News $news + * + * @param News $news * @return mixed + * * @author Foreach */ public function read(News $news) @@ -104,8 +109,10 @@ public function read(News $news) /** * 资讯投稿 + * * @author ZsyD - * @param int $news_id [资讯id] + * + * @param int $news_id [资讯id] * @return mixed */ public function release(int $news_id = 0) @@ -131,10 +138,13 @@ public function release(int $news_id = 0) /** * 文章评论列表. - * @param Request $request - * @param int $news_id [资讯id] + * + * @param Request $request + * @param int $news_id [资讯id] * @return \Illuminate\Http\JsonResponse + * * @throws \Throwable + * * @author ZsyD */ public function comments(Request $request, int $news_id) diff --git a/packages/zhiyicx-plus-pc/src/Controllers/PassportController.php b/packages/zhiyicx-plus-pc/src/Controllers/PassportController.php index 3d57bee6b..13f852abf 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/PassportController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/PassportController.php @@ -56,7 +56,9 @@ public function logout(Request $request, JWT $jwt) /** * 登录. + * * @author Foreach + * * @return mixed */ public function index() @@ -84,8 +86,10 @@ public function dynamic() /** * 验证码登录. + * * @author Foreach - * @param Request $request + * + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function dynamicLogin(Request $request) @@ -122,7 +126,9 @@ public function dynamicLogin(Request $request) /** * 注册. + * * @author Foreach + * * @param \Illuminate\Http\Request $request * @return mixed */ @@ -139,7 +145,9 @@ public function register(Request $request) /** * 找回密码 + * * @author Foreach + * * @param \Illuminate\Http\Request $request * @return mixed */ @@ -156,7 +164,9 @@ public function findPassword(Request $request) /** * 完善资料. + * * @author Foreach + * * @return mixed */ public function perfect() @@ -169,7 +179,9 @@ public function perfect() /** * 图形验证码生成. + * * @author Foreach + * * @return mixed */ public function captcha() @@ -195,8 +207,10 @@ public function captcha() /** * 图形验证码验证 + * * @author Foreach - * @param Request $request + * + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function checkCaptcha(Request $request) @@ -221,8 +235,10 @@ protected function guard() /** * 通过token登录用户. + * * @param Request $request * @return mixed + * * @author Foreach */ public function token(Request $request) diff --git a/packages/zhiyicx-plus-pc/src/Controllers/ProfileController.php b/packages/zhiyicx-plus-pc/src/Controllers/ProfileController.php index 820e64dc3..dc2602fcb 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/ProfileController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/ProfileController.php @@ -29,10 +29,13 @@ class ProfileController extends BaseController { /** * 动态 - * @param Request $request - * @param string $user [用户id 或用户名] + * + * @param Request $request + * @param string $user [用户id 或用户名] * @return mixed + * * @throws \Throwable + * * @author Foreach */ public function feeds(Request $request, ?string $user = null) @@ -81,10 +84,13 @@ public function feeds(Request $request, ?string $user = null) /** * 文章. - * @param Request $request - * @param string $user [用户id 或用户名] + * + * @param Request $request + * @param string $user [用户id 或用户名] * @return mixed + * * @throws \Throwable + * * @author 28youth */ public function news(Request $request, ?string $user = null) @@ -124,9 +130,12 @@ public function news(Request $request, ?string $user = null) /** * 收藏的动态 - * @param Request $request + * + * @param Request $request * @return mixed + * * @throws \Throwable + * * @author 28youth */ public function collectFeeds(Request $request) @@ -160,9 +169,12 @@ public function collectFeeds(Request $request) /** * 收藏的文章. - * @param Request $request + * + * @param Request $request * @return mixed + * * @throws \Throwable + * * @author 28youth */ public function collectNews(Request $request) @@ -194,9 +206,12 @@ public function collectNews(Request $request) /** * 收藏的问答. - * @param Request $request + * + * @param Request $request * @return mixed + * * @throws \Throwable + * * @author 28youth */ public function collectQuestion(Request $request) @@ -229,9 +244,12 @@ public function collectQuestion(Request $request) /** * 收藏的帖子. - * @param Request $request + * + * @param Request $request * @return mixed + * * @throws \Throwable + * * @author ZSYD */ public function collectGroup(Request $request) @@ -265,10 +283,13 @@ public function collectGroup(Request $request) /** * 问答信息. - * @param Request $request - * @param string|null $user + * + * @param Request $request + * @param string|null $user * @return mixed + * * @throws \Throwable + * * @author 28youth */ public function question(Request $request, ?string $user) diff --git a/packages/zhiyicx-plus-pc/src/Controllers/QuestionController.php b/packages/zhiyicx-plus-pc/src/Controllers/QuestionController.php index fb2f9b9bd..4da65c0be 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/QuestionController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/QuestionController.php @@ -26,8 +26,10 @@ class QuestionController extends BaseController { /** * 问答. + * * @author 28youth - * @param Request $request + * + * @param Request $request * @return mixed */ public function question(Request $request) diff --git a/packages/zhiyicx-plus-pc/src/Controllers/RankController.php b/packages/zhiyicx-plus-pc/src/Controllers/RankController.php index 0408cce8c..1d59c7508 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/RankController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/RankController.php @@ -26,8 +26,10 @@ class RankController extends BaseController { /** * 排行榜. + * * @author ZysD - * @param int|int $mold [排行榜类型] + * + * @param int|int $mold [排行榜类型] * @return mixed */ public function index(int $mold = 1) @@ -65,8 +67,10 @@ public function index(int $mold = 1) /** * 排行榜列表. + * * @author ZysD - * @param Request $request + * + * @param Request $request * @return mixed */ public function _getRankList(Request $request) @@ -159,12 +163,14 @@ public function _getRankList(Request $request) /** * 排行榜缓存. + * * @author ZysD - * @param string $key [键名] - * @param string $url [api地址] - * @param array $params [参数] - * @param int $time [时间] - * @param string $type [请求类型] + * + * @param string $key [键名] + * @param string $url [api地址] + * @param array $params [参数] + * @param int $time [时间] + * @param string $type [请求类型] * @return mixed */ public function rankCache(string $key, string $url, array $params = [], int $time = 5, string $type = 'GET') diff --git a/packages/zhiyicx-plus-pc/src/Controllers/SearchController.php b/packages/zhiyicx-plus-pc/src/Controllers/SearchController.php index 32769257f..1b3f5d560 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/SearchController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/SearchController.php @@ -26,10 +26,12 @@ class SearchController extends BaseController { /** * 搜索. + * * @author Foreach - * @param Request $request - * @param int|int $type [搜索类型] - * @param string $keywords [关键字] + * + * @param Request $request + * @param int|int $type [搜索类型] + * @param string $keywords [关键字] * @return mixed */ public function index(int $type = 1, string $keywords = '') @@ -42,8 +44,10 @@ public function index(int $type = 1, string $keywords = '') /** * 搜索获取数据. + * * @author Foreach - * @param Request $request + * + * @param Request $request * @return \Illuminate\Http\JsonResponse */ public function getData(Request $request) diff --git a/packages/zhiyicx-plus-pc/src/Controllers/SocialiteController.php b/packages/zhiyicx-plus-pc/src/Controllers/SocialiteController.php index f8ec829b1..dc0bb9eb6 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/SocialiteController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/SocialiteController.php @@ -27,9 +27,11 @@ class SocialiteController extends BaseController { /** * 三方登录/绑定（未登录）. + * * @author ZsyD - * @param Request $request - * @param string $service [三方类型] + * + * @param Request $request + * @param string $service [三方类型] * @return mixed */ public function redirectToProvider(Request $request, $service) @@ -46,9 +48,11 @@ public function redirectToProvider(Request $request, $service) /** * 三方登录/绑定（已登录）. + * * @author ZsyD - * @param Request $request - * @param string $service [三方类型] + * + * @param Request $request + * @param string $service [三方类型] * @return mixed */ public function redirectToProviderByBind(Request $request, $service) @@ -73,9 +77,11 @@ public function redirectToProviderByBind(Request $request, $service) /** * 第三方回调页. + * * @author ZsyD - * @param Request $request - * @param string $service [三方类型] + * + * @param Request $request + * @param string $service [三方类型] * @return mixed */ public function handleProviderCallback(Request $request, $service) @@ -131,8 +137,10 @@ public function handleProviderCallback(Request $request, $service) /** * 三方用户注册/绑定账号（未登录时）. + * * @author ZsyD - * @param Request $request + * + * @param Request $request * @return mixed */ public function bind(Request $request) @@ -144,7 +152,9 @@ public function bind(Request $request) /** * 获取登录信息. + * * @author ZsyD<1251992018@qq.com> + * * @param $token * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector|void */ diff --git a/packages/zhiyicx-plus-pc/src/Controllers/TopicController.php b/packages/zhiyicx-plus-pc/src/Controllers/TopicController.php index f0ee5faa6..a4cf2e2f9 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/TopicController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/TopicController.php @@ -74,7 +74,8 @@ public function index(Request $request) * 话题详情. * * @author mutoe - * @param int $topic_id + * + * @param int $topic_id */ public function detail(int $topic_id) { @@ -111,8 +112,9 @@ public function create() * 编辑话题. * * @author mutoe - * @param Request $request - * @param int $topic_id + * + * @param Request $request + * @param int $topic_id */ public function edit(int $topic_id) { diff --git a/packages/zhiyicx-plus-pc/src/Controllers/UserController.php b/packages/zhiyicx-plus-pc/src/Controllers/UserController.php index e3f191184..8bc6ae58a 100644 --- a/packages/zhiyicx-plus-pc/src/Controllers/UserController.php +++ b/packages/zhiyicx-plus-pc/src/Controllers/UserController.php @@ -26,10 +26,13 @@ class UserController extends BaseController { /** * 找伙伴. - * @param Request $request - * @param int|int $type [类型] + * + * @param Request $request + * @param int|int $type [类型] * @return mixed + * * @throws \Throwable + * * @author Foreach */ public function users(Request $request, int $type = 1) @@ -85,7 +88,9 @@ public function users(Request $request, int $type = 1) /** * 地区搜索. + * * @author 28youth + * * @return mixed */ public function area() @@ -98,10 +103,12 @@ public function area() /** * 用户粉丝. + * * @author Foreach - * @param Request $request - * @param int|int $type [类型] - * @param int|int $user_id [用户id] + * + * @param Request $request + * @param int|int $type [类型] + * @param int|int $user_id [用户id] * @return mixed */ public function follower(Request $request, int $user_id = 0) @@ -139,10 +146,12 @@ public function follower(Request $request, int $user_id = 0) /** * 用户关注. + * * @author Foreach - * @param Request $request - * @param int|int $type [类型] - * @param int|int $user_id [用户id] + * + * @param Request $request + * @param int|int $type [类型] + * @param int|int $user_id [用户id] * @return mixed */ public function following(Request $request, int $user_id = 0) diff --git a/packages/zhiyicx-plus-pc/src/Models/Navigation.php b/packages/zhiyicx-plus-pc/src/Models/Navigation.php index ff46e0ac9..eed1b79f1 100644 --- a/packages/zhiyicx-plus-pc/src/Models/Navigation.php +++ b/packages/zhiyicx-plus-pc/src/Models/Navigation.php @@ -32,8 +32,8 @@ class Navigation extends Model /** * 获取位置导航. * - * @param Builder $query - * @param int $pos 0-头部 1-底部 + * @param Builder $query + * @param int $pos 0-头部 1-底部 * @return Builder */ public function scopeByPos(Builder $query, int $pos) diff --git a/packages/zhiyicx-plus-pc/src/PcPackageHandler.php b/packages/zhiyicx-plus-pc/src/PcPackageHandler.php index 44d516b71..530c28837 100644 --- a/packages/zhiyicx-plus-pc/src/PcPackageHandler.php +++ b/packages/zhiyicx-plus-pc/src/PcPackageHandler.php @@ -35,7 +35,7 @@ class PcPackageHandler extends PackageHandler /** * Create the handler instance. * - * @param \Zhiyi\Plus\Support\Configuration $conft + * @param \Zhiyi\Plus\Support\Configuration $conft */ public function __construct(Configuration $config) { @@ -100,8 +100,9 @@ public function removeHandle($command) /** * Create a soft link to public. * - * @param \Illuminate\Console\Command $command + * @param \Illuminate\Console\Command $command * @return mixed + * * @author Seven Du */ public function linkHandle($command) @@ -126,6 +127,7 @@ public function linkHandle($command) * Delete links. * * @return void + * * @author Seven Du */ protected function unlink() @@ -142,6 +144,7 @@ protected function unlink() * Get the Publish path,. * * @return array + * * @author Seven Du */ protected function getPaths(): array diff --git a/packages/zhiyicx-plus-pc/src/PcServiceProvider.php b/packages/zhiyicx-plus-pc/src/PcServiceProvider.php index f752e4271..118349111 100644 --- a/packages/zhiyicx-plus-pc/src/PcServiceProvider.php +++ b/packages/zhiyicx-plus-pc/src/PcServiceProvider.php @@ -28,6 +28,7 @@ class PcServiceProvider extends ServiceProvider * Bootstrap the provider. * * @return void + * * @author Seven Du */ public function boot() @@ -71,6 +72,7 @@ public function boot() * register provided to provider. * * @return void + * * @author Seven Du */ public function register() @@ -89,6 +91,7 @@ public function register() * Register route. * * @return void + * * @author Seven Du */ protected function routeMap() diff --git a/packages/zhiyicx-plus-pc/src/helpers.php b/packages/zhiyicx-plus-pc/src/helpers.php index 8dea6a246..3629e9149 100644 --- a/packages/zhiyicx-plus-pc/src/helpers.php +++ b/packages/zhiyicx-plus-pc/src/helpers.php @@ -91,8 +91,8 @@ function cacheConfig() * [formatContent 动态列表内容处理]. * * @param [string] $content [内容] - * * @return [string] + * * @author Foreach */ function formatContent($content) @@ -138,8 +138,8 @@ function ($match) { * @param array $params [参数] * @param int $instance * @param int $original - * * @return + * * @author Foreach */ function inapi( @@ -181,12 +181,13 @@ function inapi( /** * [api]. * - * @param string $method [请求方式] - * @param string $url [地址] - * @param array $params [参数] - * + * @param string $method [请求方式] + * @param string $url [地址] + * @param array $params [参数] * @return mixed + * * @throws \GuzzleHttp\Exception\GuzzleException + * * @author Foreach */ function api($method = 'POST', $url = '', $params = []) @@ -218,8 +219,8 @@ function api($method = 'POST', $url = '', $params = []) * [getTime 时间转换]. * * @param [string] $time [时间] - * * @return + * * @author Foreach */ function getTime($time) @@ -256,8 +257,8 @@ function getTime($time) * @param [type] $height [高度] * @param bool $cut [是否裁剪] * @param int $blur [是否高斯模糊] - * * @return [string] + * * @author Foreach */ function getImageUrl($image = [], $width, $height, $cut = true, $blur = 0) @@ -289,6 +290,7 @@ function getImageUrl($image = [], $width, $height, $cut = true, $blur = 0) * [cacheClear 清理缓存]. * * @return + * * @author Zsyd */ function cacheClear() @@ -298,9 +300,11 @@ function cacheClear() /** * [getAvatar 获取头像]. + * * @param [type] $user [用户数组] - * @param int $width [宽度] + * @param int $width [宽度] * @return string [string] + * * @author Foreach */ function getAvatar($user, $width = 0) @@ -333,8 +337,10 @@ function getAvatar($user, $width = 0) /** * [formatMarkdown 转换markdown]. + * * @param [string] $body [内容] * @return string|string[]|null + * * @author Foreach */ function formatMarkdown($body) @@ -350,8 +356,8 @@ function formatMarkdown($body) /** * @param [string] $body [内容] - * * @return string + * * @author Foreach */ function formatList($body) @@ -371,8 +377,8 @@ function formatList($body) * [getUserInfo 获取用户信息]. * * @param [type] $id [用户id] - * * @return array + * * @author Foreach */ function getUserInfo($id): array @@ -386,6 +392,7 @@ function getUserInfo($id): array * @param $data * @param $pinneds * @return mixed + * * @author Foreach */ function formatPinneds($data, $pinneds) @@ -411,8 +418,8 @@ function formatPinneds($data, $pinneds) * [formatRepostable 转发数据组装]. * * @param [array] $feeds - * * @return [array] + * * @author Foreach */ function formatRepostable($feeds) diff --git a/tests/Feature/API2/AdvertisingTest.php b/tests/Feature/API2/AdvertisingTest.php index 50a8b120b..bd2b2b253 100644 --- a/tests/Feature/API2/AdvertisingTest.php +++ b/tests/Feature/API2/AdvertisingTest.php @@ -32,6 +32,7 @@ class AdvertisingTest extends TestCase * 测试获取广告位. * * @return void + * * @author BS <414606094@qq.com> */ public function testGetAdvertisingSpace() @@ -52,6 +53,7 @@ public function testGetAdvertisingSpace() * 测试获取一个广告位的广告列表. * * @return void + * * @author BS <414606094@qq.com> */ public function testGetAdvertising() @@ -74,6 +76,7 @@ public function testGetAdvertising() * 测试批量获取广告. * * @return void + * * @author BS <414606094@qq.com> */ public function testGetMuliteAdvertising() diff --git a/tests/Feature/API2/AuthLoginTest.php b/tests/Feature/API2/AuthLoginTest.php index d8c3204fa..eef13b30d 100644 --- a/tests/Feature/API2/AuthLoginTest.php +++ b/tests/Feature/API2/AuthLoginTest.php @@ -41,6 +41,7 @@ protected function setUp() * Test User ID login. * * @return void + * * @author Seven Du */ public function testUserLogin() @@ -71,6 +72,7 @@ public function test_user_can_not_login_with_wrong_password() * * @param [type] $response * @return void + * * @author Seven Du */ protected function assertLoginResponse($response) diff --git a/tests/Feature/API2/AuthLogoutTest.php b/tests/Feature/API2/AuthLogoutTest.php index ed8d2d92b..e7f858b44 100644 --- a/tests/Feature/API2/AuthLogoutTest.php +++ b/tests/Feature/API2/AuthLogoutTest.php @@ -63,6 +63,7 @@ protected function guard(): Guard * Test user logout. * * @return void + * * @author Seven Du */ public function testUserLogout() diff --git a/tests/Feature/API2/AuthRefreshTest.php b/tests/Feature/API2/AuthRefreshTest.php index 1cfdfa578..a178c5bdb 100644 --- a/tests/Feature/API2/AuthRefreshTest.php +++ b/tests/Feature/API2/AuthRefreshTest.php @@ -63,6 +63,7 @@ protected function guard(): Guard * Test user refresh token. * * @return void + * * @author Seven Du */ public function testUserLogout() diff --git a/tests/Feature/API2/FileUploadTest.php b/tests/Feature/API2/FileUploadTest.php index 1025908fc..5d34b20c4 100644 --- a/tests/Feature/API2/FileUploadTest.php +++ b/tests/Feature/API2/FileUploadTest.php @@ -48,6 +48,7 @@ protected function setUp() * 测试上传文件. * * @return void + * * @author BS <414606094@qq.com> */ public function testUploadFile() diff --git a/tests/Feature/API2/FileUploadedTest.php b/tests/Feature/API2/FileUploadedTest.php index e71919da0..bc6d5eee1 100644 --- a/tests/Feature/API2/FileUploadedTest.php +++ b/tests/Feature/API2/FileUploadedTest.php @@ -54,6 +54,7 @@ protected function setUp() * Test not uploaded file hash check. * * @return void + * * @author Seven Du */ public function testNotHash() @@ -72,6 +73,7 @@ public function testNotHash() * Test Uploaded file hash. * * @return void + * * @author Seven Du */ public function testUsedHash() diff --git a/tests/Feature/API2/LocationsTest.php b/tests/Feature/API2/LocationsTest.php index c4b6232be..b467d758f 100644 --- a/tests/Feature/API2/LocationsTest.php +++ b/tests/Feature/API2/LocationsTest.php @@ -26,6 +26,7 @@ class LocationsTest extends TestCase * 测试获取地区. * * @return void + * * @author BS <414606094@qq.com> */ public function testSearchLocations() @@ -39,6 +40,7 @@ public function testSearchLocations() * 测试获取热门城市. * * @return void + * * @author BS <414606094@qq.com> */ public function testGetHotLocations() diff --git a/tests/Feature/API2/OrderTest.php b/tests/Feature/API2/OrderTest.php index c1e9b85e7..853cb401b 100644 --- a/tests/Feature/API2/OrderTest.php +++ b/tests/Feature/API2/OrderTest.php @@ -47,6 +47,7 @@ protected function setUp() * 测试获取订单流水. * * @return void + * * @author BS <414606094@qq.com> */ public function testGetOrders() @@ -80,8 +81,9 @@ public function testGetOrders() /** * 断言订单基本结构. * - * @param array $singleData + * @param array $singleData * @return void + * * @author BS <414606094@qq.com> */ protected function assertOrderData(array $singleData) diff --git a/tests/Feature/API2/RegisterVerifyCodeTest.php b/tests/Feature/API2/RegisterVerifyCodeTest.php index 931bbde3d..6de8502d0 100644 --- a/tests/Feature/API2/RegisterVerifyCodeTest.php +++ b/tests/Feature/API2/RegisterVerifyCodeTest.php @@ -31,6 +31,7 @@ class RegisterVerifyCodeTest extends TestCase * 测试获取验证码. * * @return void + * * @author BS <414606094@qq.com> */ public function testGetVerifyCode() @@ -49,7 +50,6 @@ public function testGetVerifyCode() * Assert login response. * * @param $response - * * @return void */ protected function assertLoginResponse($response) diff --git a/tests/Feature/API2/ReportTest.php b/tests/Feature/API2/ReportTest.php index 8ccbcbb98..699dd989c 100644 --- a/tests/Feature/API2/ReportTest.php +++ b/tests/Feature/API2/ReportTest.php @@ -48,6 +48,7 @@ protected function setUp() * 测试举报用户. * * @return void + * * @author BS <414606094@qq.com> */ public function testReportUser() @@ -61,6 +62,7 @@ public function testReportUser() * 测试举报评论. * * @return void + * * @author BS <414606094@qq.com> */ public function testReportComment() diff --git a/tests/Feature/API2/TagsTest.php b/tests/Feature/API2/TagsTest.php index 6f1a943f5..c663188a0 100644 --- a/tests/Feature/API2/TagsTest.php +++ b/tests/Feature/API2/TagsTest.php @@ -29,6 +29,7 @@ class TagsTest extends TestCase * 测试获取标签. * * @return void + * * @author BS <414606094@qq.com> */ public function testGetTags() diff --git a/tests/Feature/API2/VerifyCodeTest.php b/tests/Feature/API2/VerifyCodeTest.php index ec850fffa..ae85222fa 100644 --- a/tests/Feature/API2/VerifyCodeTest.php +++ b/tests/Feature/API2/VerifyCodeTest.php @@ -42,6 +42,7 @@ protected function setUp() * 测试通过手机号获取验证码. * * @return void + * * @author BS <414606094@qq.com> */ public function testGetVerifyCodeByPhone() @@ -60,6 +61,7 @@ public function testGetVerifyCodeByPhone() * 测试通过邮箱获取验证码. * * @return void + * * @author BS <414606094@qq.com> */ public function testGetVerifyCodeByEmail() @@ -77,7 +79,6 @@ public function testGetVerifyCodeByEmail() * Assert login response. * * @param $response - * * @return void */ protected function assertLoginResponse($response) diff --git a/tests/Feature/API2/WalletCashTest.php b/tests/Feature/API2/WalletCashTest.php index 3ab222a38..aeb7d8f27 100644 --- a/tests/Feature/API2/WalletCashTest.php +++ b/tests/Feature/API2/WalletCashTest.php @@ -49,6 +49,7 @@ protected function setUp() * 测试获取提现记录. * * @return void + * * @author BS <414606094@qq.com> */ public function testGetCashes() @@ -75,6 +76,7 @@ public function testGetCashes() * 测试发起提现. * * @return void + * * @author BS <414606094@qq.com> */ public function testCreateCash() @@ -91,8 +93,9 @@ public function testCreateCash() /** * 断言提现数据基本结构. * - * @param array $singleData + * @param array $singleData * @return void + * * @author BS <414606094@qq.com> */ protected function assertOrderData(array $singleData) diff --git a/tests/Feature/API2/WalletTransferTest.php b/tests/Feature/API2/WalletTransferTest.php index 8e41b8b3a..c7bcd8583 100644 --- a/tests/Feature/API2/WalletTransferTest.php +++ b/tests/Feature/API2/WalletTransferTest.php @@ -43,6 +43,7 @@ protected function setUp() * 测试发起转账. * * @return void + * * @author BS <414606094@qq.com> */ public function testTransfer() diff --git a/tests/Feature/API2/WalletTransformTest.php b/tests/Feature/API2/WalletTransformTest.php index 74e127da3..daad63f24 100644 --- a/tests/Feature/API2/WalletTransformTest.php +++ b/tests/Feature/API2/WalletTransformTest.php @@ -41,6 +41,7 @@ protected function setUp() * 测试发起转换积分. * * @return void + * * @author BS <414606094@qq.com> */ public function testTransfer() diff --git a/tests/Unit/Auth/JWTAuthTokenTest.php b/tests/Unit/Auth/JWTAuthTokenTest.php index 62a69b0da..31be24d86 100644 --- a/tests/Unit/Auth/JWTAuthTokenTest.php +++ b/tests/Unit/Auth/JWTAuthTokenTest.php @@ -30,6 +30,7 @@ class JWTAuthTokenTest extends TestCase * Test create method. * * @return void + * * @author Seven Du */ public function testCreate() @@ -45,6 +46,7 @@ public function testCreate() * Test refresh method. * * @return void + * * @author Seven Du */ public function testRefresh() diff --git a/tests/Unit/Http/Controllers/APIs/V2/AuthControllerTest.php b/tests/Unit/Http/Controllers/APIs/V2/AuthControllerTest.php index b07a4e58b..d1878bca3 100644 --- a/tests/Unit/Http/Controllers/APIs/V2/AuthControllerTest.php +++ b/tests/Unit/Http/Controllers/APIs/V2/AuthControllerTest.php @@ -42,6 +42,7 @@ protected function setUp(): void * Test AuthController::class guard method. * * @return void + * * @author Seven Du */ public function testGuard() @@ -61,6 +62,7 @@ public function testGuard() * Test AuthController::class login method. * * @return void + * * @author Seven Du */ public function testLogin() @@ -141,6 +143,7 @@ public function testLogin() * Test AuthController::logout method. * * @return void + * * @author Seven Du */ public function testLogout() @@ -183,6 +186,7 @@ public function testLogout() * Test AuthController::refresh and respondWithToken method. * * @return void + * * @author Seven Du */ public function testRefreshAndTestRespondWithToken() diff --git a/tests/Unit/Packages/Wallet/OrderTest.php b/tests/Unit/Packages/Wallet/OrderTest.php index 1c2473ac4..9c8145d78 100644 --- a/tests/Unit/Packages/Wallet/OrderTest.php +++ b/tests/Unit/Packages/Wallet/OrderTest.php @@ -29,6 +29,7 @@ class OrderTest extends TestCase * Test order. * * @return void + * * @author Seven Du */ public function testOrderSetAndGetAndConstruct() @@ -42,6 +43,7 @@ public function testOrderSetAndGetAndConstruct() * Test hasSuccess method. * * @return void + * * @author Seven Du */ public function testHasSuccess() @@ -64,6 +66,7 @@ public function testHasSuccess() * Test hasFail method. * * @return void + * * @author Seven Du */ public function testHasFail() @@ -86,6 +89,7 @@ public function testHasFail() * Test hasWait method. * * @return void + * * @author Seven Du */ public function testHasWait() @@ -108,6 +112,7 @@ public function testHasWait() * Test save method. * * @return void + * * @author Seven Du */ public function testSave() @@ -135,6 +140,7 @@ public function testSave() * Test saveStateSucces method. * * @return void + * * @author Seven Du */ public function testSaveStateSuccess() @@ -160,6 +166,7 @@ public function testSaveStateSuccess() * Test saveStateFail method. * * @return void + * * @author Seven Du */ public function testSaveStateFail() @@ -185,6 +192,7 @@ public function testSaveStateFail() * Test autoComplete method. * * @return void + * * @author Seven Du */ public function testAutoComplete() @@ -233,6 +241,7 @@ public function testAutoComplete() * Test getTargetTypeManager method. * * @return void + * * @author Seven Du */ public function testGetTargetTypeManager() diff --git a/tests/Unit/Packages/Wallet/TargetTypeManagerTest.php b/tests/Unit/Packages/Wallet/TargetTypeManagerTest.php index f2532f09c..6684f1d83 100644 --- a/tests/Unit/Packages/Wallet/TargetTypeManagerTest.php +++ b/tests/Unit/Packages/Wallet/TargetTypeManagerTest.php @@ -30,6 +30,7 @@ class TargetTypeManagerTest extends TestCase * Test TargetTypeManager. * * @return void + * * @author Seven Du */ public function testBaseClass() diff --git a/tests/Unit/Packages/Wallet/TargetTypes/TargetTest.php b/tests/Unit/Packages/Wallet/TargetTypes/TargetTest.php index dca8de47c..9bfba600a 100644 --- a/tests/Unit/Packages/Wallet/TargetTypes/TargetTest.php +++ b/tests/Unit/Packages/Wallet/TargetTypes/TargetTest.php @@ -28,6 +28,7 @@ class TargetTest extends TestCase * Test target setOrder method. * * @return void + * * @author Seven Du */ public function testSetOrder() diff --git a/tests/Unit/Packages/Wallet/TypeManagerTest.php b/tests/Unit/Packages/Wallet/TypeManagerTest.php index 2658220e8..72af370a4 100644 --- a/tests/Unit/Packages/Wallet/TypeManagerTest.php +++ b/tests/Unit/Packages/Wallet/TypeManagerTest.php @@ -42,9 +42,12 @@ protected function setUp() /** * Test get default driver return. + * * @expectedException RuntimeException * @expectedExceptionMessage The manager not support default driver. + * * @return void + * * @author Seven Du */ public function testGetDefaultDriver() @@ -56,6 +59,7 @@ public function testGetDefaultDriver() * Test Create user driver. * * @return void + * * @author Seven Du */ public function testCreateUserDriver() diff --git a/tests/Unit/Packages/Wallet/Types/UserTypeTest.php b/tests/Unit/Packages/Wallet/Types/UserTypeTest.php index abcee6538..b4e63a1a9 100644 --- a/tests/Unit/Packages/Wallet/Types/UserTypeTest.php +++ b/tests/Unit/Packages/Wallet/Types/UserTypeTest.php @@ -30,6 +30,7 @@ class UserTypeTest extends TestCase * Test Transfer. * * @return void + * * @author Seven Du */ public function testTransfer() @@ -66,6 +67,7 @@ public function testTransfer() * Test createOrder method. * * @return void + * * @author Seven Du */ public function testCreateOrder() @@ -98,6 +100,7 @@ public function testCreateOrder() * Test create order model. * * @return void + * * @author Seven Du */ public function testCreateOrderModel() diff --git a/tests/Unit/Packages/Wallet/WalletTest.php b/tests/Unit/Packages/Wallet/WalletTest.php index d17929d96..a4349c63b 100644 --- a/tests/Unit/Packages/Wallet/WalletTest.php +++ b/tests/Unit/Packages/Wallet/WalletTest.php @@ -32,6 +32,7 @@ class WalletTest extends TestCase * Test Wallet::class implements. * * @return void + * * @author Seven Du */ public function testClassImplements() @@ -47,7 +48,9 @@ public function testClassImplements() * * @expectedException \Exception * @expectedExceptionMessage 传递的不是一个用户 + * * @return void + * * @author Seven Du */ public function testSetUser() @@ -82,7 +85,9 @@ public function testSetUser() * * @expectedException \Exception * @expectedExceptionMessage 没有设置钱包用户 + * * @return void + * * @author Seven Du */ public function testGetWalletModel() @@ -110,6 +115,7 @@ public function testGetWalletModel() * Test increment method. * * @return void + * * @author Seven Du */ public function testIncrement() @@ -141,6 +147,7 @@ public function testIncrement() * Test decrement method. * * @return void + * * @author Seven Du */ public function testDecrement() @@ -172,6 +179,7 @@ public function testDecrement() * Test enough method. * * @return void + * * @author Seven Du */ public function testEnough() @@ -195,6 +203,7 @@ public function testEnough() * Test toArray method. * * @return void + * * @author Seven Du */ public function testToArray() @@ -224,6 +233,7 @@ public function testToArray() * Test jsonSerialize method. * * @return void + * * @author Seven Du */ public function testJsonSerialize() @@ -245,7 +255,9 @@ public function testJsonSerialize() * Test toJson method. * * @expectedException \RuntimeException + * * @return void + * * @author Seven Du */ public function testToJson() @@ -276,6 +288,7 @@ public function testToJson() * Test __toString method. * * @return void + * * @author Seven Du */ public function test__toString()