hyperf/CHANGELOG-2.0.md
2020-08-30 23:37:12 +08:00

20 KiB

v2.0.9 - TBD

Added

  • #2331 Added auth api for nacos.
  • #2331 Added config nacos.enable to control the nacos component.
  • #2331 Added array merge mode for nacos.
  • #2377 Added ts header for gRPC request of client, compatible with Node.js gRPC server.

Fixed

  • #2331 Fixed exception thrown when the service or config was not found for nacos.
  • #2356 #2368 Fixed server:start failed, when the config of pid_file changed.
  • #2358 Fixed validation rule digits does not support int.

Optimized

  • #2359 Optimized process which stop friendly in coroutine server.
  • #2363 Optimized di which is no need to depend on config.
  • #2373 Optimized the exception handler which add content-type header automatically by default for validation.

v2.0.8 - 2020-08-24

Added

  • #2334 Added method Arr::merge to merge array more friendly than array_merge_recursive.
  • #2335 Added Hyperf/Utils/Optional which accepts any argument and allows you to access properties or call methods on that object.
  • #2336 Added RedisNsqAdapter which publish message through nsq for socketio-server.

Fixed

  • #2338 Fixed filesystem does not works when using s3 adapter.
  • #2340 Fixed __FUNCTION__ and __METHOD__ magic constants does work in closure of aop proxy class

Optimized

  • #2319 Optimized the ResolverDispatcher which is friendly for circular dependencies.

Dependencies Upgrade

  • Upgraded markrogoyski/math-php requirement from ^0.49.0 to ^1.2.0

v2.0.7 - 2020-08-17

Added

Fixed

  • #2275 Fixed bug that fetch process blocking for config center.
  • #2276 Fixed bug that the config is cleared when the config is not modified in apollo.
  • #2280 Fixed bug that interface methods will be rewriten by aop.
  • #2281 Fixed co::create failed in non-coroutine environment for hyperf/signal.
  • #2304 Fixed dead cycle when del sid for socketio memory adapter.
  • #2309 Fixed JsonRpcHttpTransporter cannot set the custom timeout property.

v2.0.6 - 2020-08-10

Added

  • #2125 Added Jet component, Jet is a unification model RPC Client, built-in JSONRPC protocol, available to running in ALL PHP environments, including PHP-FPM and Swoole/Hyperf environments.

Fixed

  • #2236 Fixed bug that select node failed when using loadBalancer for nacos.
  • #2242 Fixed bug that collect more than once time when using watcher.

v2.0.5 - 2020-08-03

Added

  • #2001 Added $signature to init command easily.
  • #2204 Added $concurrent for function parallel.

Fixed

  • #2210 Fixed bug that open event won't be executed after handshake right now.
  • #2214 Fixed bug that close event won't be executed when close the connection by websocket server.
  • #2218 Fixed bug that sender does not works for coroutine server.
  • #2227 Fixed context won't be destroyed when accept keepalive connection for co server.

Optimized

  • #2193 Optimized the scan accuracy for Hyperf\Watcher\Driver\FindDriver.
  • #2232 Optimized eager load when the type is In or InRaw for model-cache.

v2.0.4 - 2020-07-27

Added

  • #2144 Added filed $result for QueryExecuted.
  • #2158 Added route options to route handler.
  • #2162 Added Hyperf\Watcher\Driver\FindDriver for hyperf/watcher.
  • #2169 Added session.options.domain for hyperf/session to change the domain which get from request.
  • #2174 Added ModelRewriteTimestampsVisitor to rewrite $timestamps based on created_at and updated_at for Model.
  • #2175 Added ModelRewriteSoftDeletesVisitor to insert or remove SoftDeletes based on deleted_at for Model.
  • #2176 Added ModelRewriteKeyInfoVisitor to rewrite $incrementing $primaryKey and $keyType for Model.

Fixed

  • #2149 Fixed bug that custom processes cannot fetch config from nacos.
  • #2159 Fixed fatal exception caused by exist file when using gen:migration.

Optimized

  • #2043 Throw an exception when none of the scan directories exists.
  • #2182 Don't record the close message when the server is not websocket server.

v2.0.3 - 2020-07-20

Added

  • #1554 Added hyperf/nacos component.
  • #2082 Added SIGINT listened by Hyperf\Signal\Handler\WorkerStopHandler.
  • #2097 Added TencentCloud COS for hyperf/filesystem.
  • #2122 Added \Hyperf\Snowflake\Concern\HasSnowflake Trait to integrate hyperf/snowflake and database models.

Fixed

  • #2017 Fixed when prometheus using the redis record, an error is reported during the rendering of data due to the change in the number of label.
  • #2117 Fixed @Inject will be useless sometimes when using server:watch.
  • #2123 Fixed bug that redis::call will be recorded twice.
  • #2139 Fixed bug that ValidationMiddleware will throw exception in websocket.
  • #2140 Fixed a case where session are not saved when exception occurs.

Optimized

  • #2080 Optimized the type of $perPage from int to ?int for method Hyperf\Database\Model\Builder::paginate.
  • #2110 Don't kill SIGTERM if the process not exists for hyperf/watcher.
  • #2116 Optimized requirement for hyperf/di.
  • #2121 Replaced the default @property if user redeclare it when using gen:model.
  • #2129 Optimized the exception message when the response json encoding failed.

v2.0.2 - 2020-07-13

Added

  • #2018 Make prometheus use redis to store data to support cluster mode

Fixed

  • #1898 Fixed crontab rule $min-$max parsing errors.
  • #2037 Fixed bug that tcp server running in only one coroutine.
  • #2051 Fixed hyperf.pid won't be created in coroutine server.
  • #2055 Fixed guzzle auto add Expect: 100-Continue header when put a large file.
  • #2059 Fixed redis reconnection bug in socket.io server.
  • #2067 Fixed bug that syntax parse error will cause worker exceptions for hyperf/watcher.
  • #2085 Fixed bug in RetryFalsy Annotation that leads to retrying truthy results.
  • #2089 Fixed class of command won't be loaded after gen:command.
  • #2093 Fixed type error for command vendor:publish.

Added

  • #1860 Added OnWorkerExit callback by default for server.
  • #2042 Added ScanFileDriver to watch file changes for hyperf/watcher.
  • #2054 Added eager load relation for model-cache.

Optimized

  • #2049 Optimized stdout when server restart for hyperf/watcher.
  • #2090 Adapte original response object for hyperf/session.

Changed

  • #2031 The code of constants only support int and string.
  • #2065 Changed Hyperf\WebSocketServer\Sender which only support push and disconnect.
  • #2100 Upgrade doctrine/inflector to ^2.0 for hyperf/utils.

Removed

  • #2065 Removed methods send sendto and close from Hyperf\WebSocketServer\Sender.

v2.0.1 - 2020-07-02

Added

  • #1934 Added command gen:constant.
  • #1982 Added watcher component.

Fixed

  • #1952 Fixed bug that migration will be created although class already exists.
  • #1960 Fixed Hyperf\HttpServer\ResponseEmitter::isMethodsExists() method does not works as expected.
  • #1961 Fixed start failed when config/autoload/aspects.php does not exists.
  • #1964 Fixed http status code 500 caused by empty body.
  • #1965 Fixed the wrong http code when initRequestAndResponse failed.
  • #1968 Fixed aspect does not work as expected after aspects.php is edited.
  • #1985 Fixed global_imports do not work when the aliases are not all lowercase letters.
  • #1990 Fixed @Inject does not work when the parent class has the same property.
  • #2019 Fixed bug that gen:model generate property failed, when used morphTo or where.
  • #2026 Fixed invalid lazy proxy generation when magic methods are used.

Changed

  • #1986 Changed exit_code 0 to SIGTERM when swoole short name do not set disable.

Optimized

  • #1959 Make ClassLoader easier to be extended.
  • #2002 Support aop in trait when php version >= 7.3.

v2.0.0 - 2020-06-22

Major Changes

  1. Refactor hyperf/di component, in particular, AOP and Annotation Scanner are optimized, in v2.0, the component use a brand new loading mechanism to provided an incredible AOP function.
    1. The most significant functional differences compared to v1.x is that you can cut into any classes in any ways with Aspect. For example, in v1.x, you can only use AOP in the class instance that created by Hyperf DI container, you cannot cut into the class instance that created by new identifier. But now, in v2.0, it is available. But there is still has an exception, the classes that used in bootstrap stage still cannot works.
    2. In v1.x, the AOP ONLY available for the normal classes, not for Final class that cannot be inherited by a subclass. But now, in v2.0. it is available.
    3. In v1.x, you cannot use the property value that marked by @Inject or @Value annotation in the constructor of current class. But now, in v2.0, it is available.
    4. In v1.x, you can only use @Inject and @Value annotation in the class instance that created by Hyperf DI container. But now, in v2.0, it is available in any ways, such as the class instance that created by new identifier.
    5. In v1.x, you have to define the full namespace of Annotation class when you use the Annotation. But now, in v2.0, the component provide a global import mechanism, you cloud define an alias for Annotation to use the Annotation directly without using the namespace. For example, you cloud define @Inject annotation in any class without define use Hyperf\Di\Annotation\Inject;.
    6. In v1.x, the proxy class that created by the DI container is a subclass of the target class, this mechanism will cause the magic constant will return the value of proxy class but not original class, such as __CLASS__. But now, in v2.0, the proxy class will keep the same structure with the original class, will not change the class name or the class structure.
    7. In v1.x, the proxy class will not re-generate when the proxy file exists even the code of the proxy class changed, this strategy will improve the time-consuming of scan, but at the same time, this will lead to a certain degree of development inconvenience. And now, in v2.0, the file cache of proxy class will generated according to the code content of the proxy class, this changes will reduces the mental burden of development.
    8. Add priority parameter for Aspect, now you could define priority in Aspect class by class property or annotation property, to manage the order of the aspects.
    9. In v1.x, you can only define an Aspect class by @Aspect annotation, you cannot define the Aspect class by configuration file. But now, in v2.0, it is available to define the Aspect class by configuration file or ConfigProvider.
    10. In v1.x, you have to add Hyperf\Di\Listener\LazyLoaderBootApplicationListener to enable lazy loading. In 2.0, lazy loading can be used directly. This listener is therefore removed.
    11. Added annotations.scan.class_map configuration, now you could replace any content of class dynamically above the autoload rules.

Dependencies Upgrade

  • Upgraded ext-swoole to >=4.5;
  • Upgraded psr/event-dispatcher to ^1.0;
  • Upgraded monolog/monolog to ^2.0;
  • Upgraded phpstan/phpstan to ^0.12.18;
  • Upgraded vlucas/phpdotenv to ^4.0;
  • Upgraded symfony/finder to ^5.0;
  • Upgraded symfony/event-dispatcher to ^5.0;
  • Upgraded symfony/console to ^5.0;
  • Upgraded symfony/property-access to ^5.0;
  • Upgraded symfony/serializer to ^5.0;
  • Upgraded elasticsearch/elasticsearch to ^7.0;

Removed

  • Removed Hyperf\Di\Aop\AstCollector;
  • Removed Hyperf\Di\Aop\ProxyClassNameVisitor;
  • Removed Hyperf\Di\Listener\LazyLoaderBootApplicationListener
  • Removed method dispatch(...$params) from Hyperf\Dispatcher\AbstractDispatcher
  • Removed mapping for Hyperf\Contract\NormalizerInterface => Hyperf\Utils\Serializer\SymfonyNormalizer from ConfigProvider in utils.
  • Removed the typehint of $server parameter of Hyperf\Contract\OnOpenInterfaceHyperf\Contract\OnCloseInterfaceHyperf\Contract\OnMessageInterfaceHyperf\Contract\OnReceiveInterface;

Added

  • #992 Added ReactiveX component.

  • #1245 Added Annotation ExceptionHandler.

  • #1245 Exception handler's config and annotation support priority.

  • #1819 Added hyperf/signal component.

  • #1844 Support type \DateInterval for ttl in model-cache.

  • #1855 Added ConstantFrequency to flush one connection, when it is idle connection for the interval of time.

  • #1871 Added sink for guzzle.

  • #1805 Added Coroutine Server.

    • Changed method bind(Server $server) to bind($server) in Hyperf\Contract\ProcessInterface.
    • Changed method isEnable() to isEnable($server) in Hyperf\Contract\ProcessInterface
    • Process mode of config-center, crontab, metric, comsumers of MQ can not running in coroutine server.
    • Change the life-cycle of Hyperf\AsyncQueue\Environment, can only applies in the current coroutine, not the whole current process.
    • Coroutine Server does not support task mechanism.
  • #1877 Support to use typehint of property on PHP 8 to replace @var when using @Inject annotation, for example:

class Example {
    /**
    * @Inject
    */
    private ExampleService $exampleService;
}
  • #1890 Added Hyperf\HttpServer\ResponseEmitter class to emit any PSR-7 response object with Swoole server, and extracted Hyperf\Contract\ResponseEmitterInterface.
  • #1890 Added getTrailers() and getTrailer(string $key) and withTrailer(string $key, $value) methods for Hyperf\HttpMessage\Server\Response.
  • #1920 Added method Hyperf\WebSocketServer\Sender::close(int $fd, bool $reset = null).

Fixed

  • #1825 Fixed TypeError for StartServer::execute.
  • #1854 Fixed is_resource does not works when use Runtime::enableCoroutine() privately in filesystem.
  • #1900 Fixed caster decimal of Model does not work.
  • #1917 Fixed Request::isXmlHttpRequest does not work.

Changed

  • #705 Uniformed the handling of HTTP exceptions, now unified throwing a Hyperf\HttpMessage\Exception\HttpException exception class to replace the way of direct response in Dispatcher, also provided an Hyperf\HttpServer\Exception\Handler\ httptionHandler ExceptionHandler to handle these HTTP Exception;
  • #1846 Don't auto change the impl for Hyperf\Contract\NormalizerInterface when you require symfony/serialize. You can added dependiencies below to use symfony serializer.
use Hyperf\Utils\Serializer\SerializerFactory;
use Hyperf\Utils\Serializer\Serializer;

return [
    Hyperf\Contract\NormalizerInterface::class => new SerializerFactory(Serializer::class),
];
  • #1924 Changed Hyperf\GrpcClient\BaseClient methods simpleRequest, getGrpcClient, clientStreamRequest to _simpleRequest, _getGrpcClient, _clientStreamRequest.

Removed

  • #1890 Removed Hyperf\Contract\Sendable interface and all implementations of it.
  • #1905 Removed config config/server.php, you can merge it into config/config.php.

Optimized

  • #1793 Socket.io server now only dispatch connect/disconnect events in onOpen and onClose. Also upgrade some class members from private to protected, so users can hack them.
  • #1848 Auto generate rpc client code when server start and the interface is changed.
  • #1863 Support async-queue stop safely.
  • #1896 Keys will be merged when different constants use the same code.