├── LICENSE
├── README.md
├── composer.json
├── config
    └── config.php
└── src
    ├── Aop
        ├── AfterReturningJoinPoint.php
        ├── AfterThrowingJoinPoint.php
        ├── Annotation
        │   ├── After.php
        │   ├── AfterReturning.php
        │   ├── AfterThrowing.php
        │   ├── Around.php
        │   ├── Aspect.php
        │   ├── BaseInjectValue.php
        │   ├── Before.php
        │   ├── CallableValue.php
        │   ├── ConstValue.php
        │   ├── FilterArg.php
        │   ├── Inject.php
        │   ├── InjectArg.php
        │   ├── PointCut.php
        │   └── RequestInject.php
        ├── Aop
        │   ├── FilterArgAop.php
        │   └── InjectArgAop.php
        ├── AopAnnotationLoader.php
        ├── AopManager.php
        ├── AroundJoinPoint.php
        ├── JoinPoint.php
        ├── Listener
        │   ├── BuildRuntimeListener.php
        │   ├── ImiInit.php
        │   └── LoadRuntimeListener.php
        ├── Model
        │   └── AopItem.php
        └── PointCutType.php
    ├── App.php
    ├── AppContexts.php
    ├── Async
        ├── Annotation
        │   ├── Async.php
        │   ├── Defer.php
        │   └── DeferAsync.php
        ├── Aop
        │   └── AsyncAop.php
        ├── Async.php
        ├── AsyncResult.php
        ├── Contract
        │   ├── IAsyncHandler.php
        │   └── IAsyncResult.php
        ├── Exception
        │   └── AsyncTimeoutException.php
        └── Sync
        │   └── SyncHandler.php
    ├── Bean
        ├── Annotation.php
        ├── Annotation
        │   ├── AnnotationManager.php
        │   ├── Base.php
        │   ├── Bean.php
        │   ├── Callback.php
        │   ├── ClassEventListener.php
        │   ├── Inherit.php
        │   ├── Listener.php
        │   ├── Model
        │   │   ├── AnnotationRelation.php
        │   │   ├── ClassAnnotation.php
        │   │   ├── ClassAnnotationRelation.php
        │   │   ├── ConstantAnnotationRelation.php
        │   │   ├── IAnnotationRelation.php
        │   │   ├── MethodAnnotationRelation.php
        │   │   └── PropertyAnnotationRelation.php
        │   ├── Parser.php
        │   └── Partial.php
        ├── AnnotationLoader.php
        ├── AnnotationParser.php
        ├── BeanFactory.php
        ├── BeanManager.php
        ├── BeanProxy.php
        ├── Container.php
        ├── Exception
        │   ├── ContainerException.php
        │   └── NotFoundException.php
        ├── IBean.php
        ├── Listener
        │   ├── BuildRuntimeListener.php
        │   └── LoadRuntimeListener.php
        ├── Parser
        │   ├── BaseParser.php
        │   ├── BeanParser.php
        │   ├── ClassEventParser.php
        │   ├── IParser.php
        │   ├── ListenerParser.php
        │   ├── NullParser.php
        │   └── PartialParser.php
        ├── PartialManager.php
        ├── ReflectionContainer.php
        ├── ReflectionUtil.php
        ├── Scanner.php
        ├── Traits
        │   └── TAutoInject.php
        └── Util
        │   ├── AttributeUtil.php
        │   ├── PhpParser.php
        │   └── TokenParser.php
    ├── Cache
        ├── Annotation
        │   ├── CacheEvict.php
        │   ├── CachePut.php
        │   └── Cacheable.php
        ├── Aop
        │   ├── CacheEvictAop.php
        │   ├── CachePutAop.php
        │   ├── CacheableAop.php
        │   └── TCacheAopHelper.php
        ├── CacheException.php
        ├── CacheManager.php
        ├── Handler
        │   ├── Apcu.php
        │   ├── Base.php
        │   ├── File.php
        │   ├── Memory.php
        │   ├── Redis.php
        │   ├── RedisHash.php
        │   └── RequestContext.php
        └── InvalidArgumentException.php
    ├── Cli
        ├── Annotation
        │   ├── Argument.php
        │   ├── Command.php
        │   ├── CommandAction.php
        │   └── Option.php
        ├── ArgType.php
        ├── CliApp.php
        ├── CliAppContexts.php
        ├── CliManager.php
        ├── Contract
        │   └── BaseCommand.php
        ├── Event
        │   └── CommandEvents.php
        ├── ImiArgvInput.php
        ├── ImiCommand.php
        ├── ImiConsoleOutput.php
        ├── Listener
        │   ├── BuildRuntimeListener.php
        │   └── LoadRuntimeListener.php
        ├── Parser
        │   └── ToolParser.php
        ├── Tools
        │   └── Imi
        │   │   └── Imi.php
        ├── bin
        │   └── imi-cli
        └── bootstrap.php
    ├── Config.php
    ├── Config
        ├── Annotation
        │   ├── ConfigValue.php
        │   └── EnvValue.php
        └── DotEnv
        │   ├── DotEnv.php
        │   ├── EntryParser.php
        │   └── Parser.php
    ├── ConnectionContext.php
    ├── Contract
        └── IWorker.php
    ├── Controller
        ├── HttpController.php
        ├── README.md
        ├── TcpController.php
        ├── UdpController.php
        └── WebSocketController.php
    ├── Core
        ├── App
        │   ├── Contract
        │   │   ├── BaseApp.php
        │   │   └── IApp.php
        │   └── Enum
        │   │   └── LoadRuntimeResult.php
        ├── Component
        │   ├── ComponentManager.php
        │   └── Listener
        │   │   ├── BuildRuntimeListener.php
        │   │   └── LoadRuntimeListener.php
        ├── Context
        │   ├── ContextData.php
        │   ├── Contract
        │   │   └── IContextManager.php
        │   ├── DefaultContextManager.php
        │   └── Exception
        │   │   ├── ContextExistsException.php
        │   │   └── ContextNotFoundException.php
        ├── CoreEvents.php
        └── Runtime
        │   ├── Contract
        │       └── IRuntimeModeHandler.php
        │   ├── Event
        │       ├── BuildRuntimeInfoEvent.php
        │       └── LoadRuntimeInfoEvent.php
        │   ├── Handler
        │       └── DefaultRuntimeModeHandler.php
        │   └── Runtime.php
    ├── Cron
        ├── Annotation
        │   └── Cron.php
        ├── Client.php
        ├── Consts
        │   ├── CronTaskType.php
        │   └── UniqueLevel.php
        ├── Contract
        │   ├── ICronManager.php
        │   ├── ICronTask.php
        │   └── IScheduler.php
        ├── CronCalculator.php
        ├── CronLock.php
        ├── CronManager.php
        ├── CronRule.php
        ├── CronTask.php
        ├── CronWorker.php
        ├── Listener
        │   └── Init.php
        ├── Message
        │   ├── AddCron.php
        │   ├── Clear.php
        │   ├── CommonMsg.php
        │   ├── GetRealTasks.php
        │   ├── GetTask.php
        │   ├── HasTask.php
        │   ├── IMessage.php
        │   ├── RemoveCron.php
        │   └── Result.php
        ├── Scheduler.php
        ├── Traits
        │   └── TWorkerReport.php
        └── Util
        │   └── CronUtil.php
    ├── Env.php
    ├── Event
        ├── CaseInsensitiveListenerProvider.php
        ├── ClassEventManager.php
        ├── CommonEvent.php
        ├── Contract
        │   ├── IEvent.php
        │   ├── IEventDispatcher.php
        │   └── IListenerProvider.php
        ├── Event.php
        ├── EventController.php
        ├── EventDispatcher.php
        ├── EventManager.php
        ├── EventParam.php
        ├── IEvent.php
        ├── IEventListener.php
        ├── Listener
        │   ├── BuildRuntimeListener.php
        │   └── LoadRuntimeListener.php
        ├── ListenerProvider.php
        ├── RegisteredListener.php
        └── TEvent.php
    ├── Facade
        ├── Annotation
        │   └── Facade.php
        ├── BaseFacade.php
        └── Cli
        │   ├── FacadeGenerate.php
        │   └── template.tpl
    ├── HotUpdate
        ├── Event
        │   ├── HotUpdateBeginBuildEvent.php
        │   └── HotUpdateEvents.php
        └── Monitor
        │   ├── BaseMonitor.php
        │   ├── FileMTime.php
        │   ├── IMonitor.php
        │   └── Inotify.php
    ├── HttpValidate
        ├── Annotation
        │   └── HttpValidation.php
        └── Aop
        │   └── AutoValidationAop.php
    ├── IDEHelper
        └── BuildIDEHelper.php
    ├── Lock
        ├── Annotation
        │   └── Lockable.php
        ├── Aop
        │   ├── LockAop.php
        │   └── TLockableParser.php
        ├── Exception
        │   └── LockFailException.php
        ├── Handler
        │   ├── BaseLock.php
        │   ├── ILockHandler.php
        │   └── Redis.php
        ├── Lock.php
        └── LockConfigOption.php
    ├── Log
        ├── AbstractErrorEventHandler.php
        ├── ErrorLog.php
        ├── Formatter
        │   └── ConsoleLineFormatter.php
        ├── Handler
        │   └── ConsoleHandler.php
        ├── IErrorEventHandler.php
        ├── Log.php
        ├── LogLevel.php
        ├── Logger.php
        └── MonoLogger.php
    ├── Main.php
    ├── Main
        ├── AppBaseMain.php
        ├── BaseMain.php
        ├── Helper.php
        └── IMain.php
    ├── Pool
        ├── Annotation
        │   └── PoolResource.php
        ├── BasePool.php
        ├── BasePoolResource.php
        ├── BaseSyncPool.php
        ├── Event
        │   └── CheckPoolResourceEvent.php
        ├── Interfaces
        │   ├── IPool.php
        │   ├── IPoolConfig.php
        │   └── IPoolResource.php
        ├── Listener
        │   ├── ClearListener.php
        │   ├── RequestContextDestroy.php
        │   └── WorkerStart.php
        ├── PoolConfig.php
        ├── PoolItem.php
        ├── PoolManager.php
        ├── ResourceConfigMode.php
        └── TUriResourceConfig.php
    ├── Process
        ├── AutoRunProcessManager.php
        └── Event
        │   ├── ProcessBeginEvent.php
        │   ├── ProcessEndEvent.php
        │   └── ProcessEvents.php
    ├── Redis
        ├── Annotation
        │   └── RedisInject.php
        ├── Enum
        │   └── RedisMode.php
        ├── Listener
        │   └── CheckPoolResource.php
        ├── Redis.php
        ├── RedisHandler.php
        ├── RedisManager.php
        ├── RedisResource.php
        ├── SyncRedisPool.php
        └── Traits
        │   └── TRedisPool.php
    ├── RequestContext.php
    ├── RequestContextProxy
        ├── Annotation
        │   └── RequestContextProxy.php
        ├── BaseRequestContextProxy.php
        └── Cli
        │   ├── RequestContextProxyGenerate.php
        │   └── template.tpl
    ├── Server
        ├── Annotation
        │   └── ServerInject.php
        ├── ConnectionContext
        │   ├── Event
        │   │   ├── ConnectionContextEvents.php
        │   │   ├── Listener
        │   │   │   └── IConnectionContextRestoreListener.php
        │   │   └── Param
        │   │   │   └── ConnectionContextRestoreParam.php
        │   ├── StoreHandler.php
        │   ├── StoreHandler
        │   │   ├── IHandler.php
        │   │   ├── Local.php
        │   │   └── Redis.php
        │   └── Traits
        │   │   └── TConnectionContextRelease.php
        ├── Contract
        │   ├── BaseServer.php
        │   ├── IServer.php
        │   └── IServerUtil.php
        ├── DataParser
        │   ├── DataParser.php
        │   ├── IParser.php
        │   ├── JsonArrayParser.php
        │   └── JsonObjectParser.php
        ├── Event
        │   ├── AfterCreateServerEvent.php
        │   ├── BeforeCreateServerEvent.php
        │   ├── PipeMessageEvent.php
        │   ├── ServerEvents.php
        │   ├── WorkerStartEvent.php
        │   └── WorkerStopEvent.php
        ├── Group
        │   ├── ClientIdMap.php
        │   ├── Contract
        │   │   └── IServerGroup.php
        │   ├── Event
        │   │   ├── JoinGroupEvent.php
        │   │   ├── LeaveGroupEvent.php
        │   │   └── ServerGroupEvents.php
        │   ├── Exception
        │   │   └── MethodNotFoundException.php
        │   ├── Group.php
        │   ├── Handler
        │   │   ├── IGroupHandler.php
        │   │   ├── Local.php
        │   │   └── Redis.php
        │   ├── Listener
        │   │   └── GroupRestore.php
        │   └── TServerGroup.php
        ├── Http
        │   ├── Annotation
        │   │   └── RequestParam.php
        │   ├── Cli
        │   │   ├── ControllerGenerate.php
        │   │   ├── restTemplate.tpl
        │   │   └── template.tpl
        │   ├── Controller
        │   │   └── HttpController.php
        │   ├── Dispatcher.php
        │   ├── Error
        │   │   ├── ErrorHandler.php
        │   │   ├── ExecuteTimeoutHandler.php
        │   │   ├── HttpNotFoundHandler.php
        │   │   ├── IErrorHandler.php
        │   │   ├── IExecuteTimeoutHandler.php
        │   │   ├── IHttpNotFoundHandler.php
        │   │   └── JsonErrorHandler.php
        │   ├── Listener
        │   │   └── HttpRouteInit.php
        │   ├── Message
        │   │   ├── Contract
        │   │   │   ├── IHttpRequest.php
        │   │   │   └── IHttpResponse.php
        │   │   ├── Emitter
        │   │   │   ├── Contract
        │   │   │   │   ├── BaseEmitter.php
        │   │   │   │   └── IResponseBodyEmitter.php
        │   │   │   ├── Handler
        │   │   │   │   └── IEmitHandler.php
        │   │   │   ├── SseEmitter.php
        │   │   │   └── SseMessageEvent.php
        │   │   ├── Proxy
        │   │   │   ├── RequestProxy.php
        │   │   │   ├── RequestProxyObject.php
        │   │   │   ├── ResponseProxy.php
        │   │   │   └── ResponseProxyObject.php
        │   │   ├── Request.php
        │   │   ├── Response.php
        │   │   └── UploadedFile.php
        │   ├── Middleware
        │   │   ├── ActionMiddleware.php
        │   │   ├── ActionWrapMiddleware.php
        │   │   ├── OptionsMiddleware.php
        │   │   └── RouteMiddleware.php
        │   ├── Parser
        │   │   └── ControllerParser.php
        │   ├── RequestHandler.php
        │   ├── Route
        │   │   ├── Annotation
        │   │   │   ├── Action.php
        │   │   │   ├── Controller.php
        │   │   │   ├── Middleware.php
        │   │   │   └── Route.php
        │   │   ├── HttpRoute.php
        │   │   ├── RouteItem.php
        │   │   ├── RouteResult.php
        │   │   └── Router.php
        │   ├── Struct
        │   │   └── ActionMethodItem.php
        │   └── SuperGlobals
        │   │   ├── Cookie.php
        │   │   ├── Files.php
        │   │   ├── Get.php
        │   │   ├── Listener
        │   │       └── SuperGlobals.php
        │   │   ├── Post.php
        │   │   ├── Request.php
        │   │   ├── Server.php
        │   │   └── Session.php
        ├── Protocol.php
        ├── Route
        │   └── TMiddleware.php
        ├── Server.php
        ├── ServerManager.php
        ├── Session
        │   ├── Handler
        │   │   ├── Base.php
        │   │   ├── File.php
        │   │   ├── ISessionHandler.php
        │   │   └── Redis.php
        │   ├── Middleware
        │   │   └── HttpSessionMiddleware.php
        │   ├── Session.php
        │   ├── SessionConfig.php
        │   ├── SessionCookie.php
        │   └── SessionManager.php
        ├── TcpServer
        │   ├── Contract
        │   │   └── ITcpServer.php
        │   ├── Controller
        │   │   └── TcpController.php
        │   ├── Dispatcher.php
        │   ├── Error
        │   │   ├── ErrorHandler.php
        │   │   ├── IErrorHandler.php
        │   │   ├── ITcpRouteNotFoundHandler.php
        │   │   └── TcpRouteNotFoundHandler.php
        │   ├── IReceiveHandler.php
        │   ├── Listener
        │   │   └── TcpRouteInit.php
        │   ├── Message
        │   │   ├── IReceiveData.php
        │   │   ├── Proxy
        │   │   │   └── ReceiveDataProxy.php
        │   │   └── ReceiveData.php
        │   ├── Middleware
        │   │   ├── ActionMiddleware.php
        │   │   ├── ActionWrapMiddleware.php
        │   │   ├── IMiddleware.php
        │   │   └── RouteMiddleware.php
        │   ├── Parser
        │   │   └── TcpControllerParser.php
        │   ├── ReceiveHandler.php
        │   └── Route
        │   │   ├── Annotation
        │   │       ├── TcpAction.php
        │   │       ├── TcpController.php
        │   │       ├── TcpMiddleware.php
        │   │       └── TcpRoute.php
        │   │   ├── IRoute.php
        │   │   ├── RouteItem.php
        │   │   ├── RouteResult.php
        │   │   └── TcpRoute.php
        ├── UdpServer
        │   ├── Contract
        │   │   └── IUdpServer.php
        │   ├── Controller
        │   │   └── UdpController.php
        │   ├── Dispatcher.php
        │   ├── Error
        │   │   ├── ErrorHandler.php
        │   │   ├── IErrorHandler.php
        │   │   ├── IUdpRouteNotFoundHandler.php
        │   │   └── UdpRouteNotFoundHandler.php
        │   ├── IPacketHandler.php
        │   ├── Listener
        │   │   └── UdpRouteInit.php
        │   ├── Message
        │   │   ├── IPacketData.php
        │   │   ├── PacketData.php
        │   │   └── Proxy
        │   │   │   └── PacketDataProxy.php
        │   ├── Middleware
        │   │   ├── ActionMiddleware.php
        │   │   ├── ActionWrapMiddleware.php
        │   │   ├── IMiddleware.php
        │   │   └── RouteMiddleware.php
        │   ├── PacketHandler.php
        │   ├── Parser
        │   │   └── UdpControllerParser.php
        │   └── Route
        │   │   ├── Annotation
        │   │       ├── UdpAction.php
        │   │       ├── UdpController.php
        │   │       ├── UdpMiddleware.php
        │   │       └── UdpRoute.php
        │   │   ├── IRoute.php
        │   │   ├── RouteItem.php
        │   │   ├── RouteResult.php
        │   │   └── UdpRoute.php
        ├── View
        │   ├── Annotation
        │   │   ├── BaseViewOption.php
        │   │   ├── HtmlView.php
        │   │   ├── JsonView.php
        │   │   ├── View.php
        │   │   └── XmlView.php
        │   ├── Engine
        │   │   ├── IEngine.php
        │   │   └── Php.php
        │   ├── Handler
        │   │   ├── Html.php
        │   │   ├── IHandler.php
        │   │   ├── Json.php
        │   │   └── Xml.php
        │   ├── Parser
        │   │   └── ViewParser.php
        │   └── View.php
        └── WebSocket
        │   ├── Contract
        │       └── IWebSocketServer.php
        │   ├── Controller
        │       └── WebSocketController.php
        │   ├── Dispatcher.php
        │   ├── Enum
        │       └── NonControlFrameType.php
        │   ├── Error
        │       ├── ErrorHandler.php
        │       ├── IErrorHandler.php
        │       ├── IWSRouteNotFoundHandler.php
        │       └── WSRouteNotFoundHandler.php
        │   ├── IMessageHandler.php
        │   ├── Listener
        │       └── WSRouteInit.php
        │   ├── Message
        │       ├── Frame.php
        │       ├── IFrame.php
        │       └── Proxy
        │       │   └── FrameProxy.php
        │   ├── MessageHandler.php
        │   ├── Middleware
        │       ├── ActionMiddleware.php
        │       ├── ActionWrapMiddleware.php
        │       ├── IMiddleware.php
        │       └── RouteMiddleware.php
        │   ├── Parser
        │       └── WSControllerParser.php
        │   └── Route
        │       ├── Annotation
        │           ├── WSAction.php
        │           ├── WSConfig.php
        │           ├── WSController.php
        │           ├── WSMiddleware.php
        │           └── WSRoute.php
        │       ├── IRoute.php
        │       ├── RouteItem.php
        │       ├── RouteResult.php
        │       └── WSRoute.php
    ├── Timer
        ├── Contract
        │   └── ITimer.php
        ├── Handler
        │   └── DefaultTimer.php
        └── Timer.php
    ├── Util
        ├── ArrayData.php
        ├── ArrayList.php
        ├── ArrayUtil.php
        ├── Bit.php
        ├── ClassObject.php
        ├── Composer.php
        ├── DateTime.php
        ├── DelayBeanCallable.php
        ├── DelayClassCallable.php
        ├── DelayServerBeanCallable.php
        ├── Digital.php
        ├── DocBlock.php
        ├── EnumUtil.php
        ├── ExpiredStorage.php
        ├── File.php
        ├── File
        │   └── FileEnumItem.php
        ├── FilterableList.php
        ├── Format
        │   ├── IFormat.php
        │   ├── Json.php
        │   ├── PhpSerialize.php
        │   └── PhpSession.php
        ├── Http
        │   ├── AbstractMessage.php
        │   ├── Consts
        │   │   ├── MediaType.php
        │   │   ├── RequestHeader.php
        │   │   ├── RequestMethod.php
        │   │   ├── ResponseHeader.php
        │   │   └── StatusCode.php
        │   ├── Contract
        │   │   ├── IMessage.php
        │   │   ├── IRequest.php
        │   │   ├── IResponse.php
        │   │   └── IServerRequest.php
        │   ├── MessageUtil.php
        │   ├── Request.php
        │   ├── Response.php
        │   └── ServerRequest.php
        ├── Imi.php
        ├── ImiPriority.php
        ├── Interfaces
        │   ├── IArrayable.php
        │   └── IHashCode.php
        ├── LazyArrayObject.php
        ├── MemoryTable
        │   └── IMemoryTableOption.php
        ├── ObjectArrayHelper.php
        ├── Pagination.php
        ├── Process.php
        ├── Process
        │   ├── ProcessAppContexts.php
        │   └── ProcessType.php
        ├── Random.php
        ├── Socket
        │   └── IPEndPoint.php
        ├── StaticValueStorage.php
        ├── Stream
        │   ├── FileStream.php
        │   ├── MemoryStream.php
        │   └── StreamMode.php
        ├── System.php
        ├── Text.php
        ├── Traits
        │   ├── TAnonymous.php
        │   ├── TBeanRealClass.php
        │   ├── TDataToProperty.php
        │   ├── THashCode.php
        │   ├── TNotRequiredDataToProperty.php
        │   ├── TServerAnnotationParser.php
        │   ├── TSingleton.php
        │   └── TStaticClass.php
        └── Uri.php
    ├── Validate
        ├── Annotation
        │   ├── AutoValidation.php
        │   ├── Compare.php
        │   ├── Condition.php
        │   ├── Decimal.php
        │   ├── InEnum.php
        │   ├── InList.php
        │   ├── Integer.php
        │   ├── Number.php
        │   ├── Regex.php
        │   ├── Required.php
        │   ├── Scene.php
        │   ├── Text.php
        │   └── ValidateValue.php
        ├── Aop
        │   └── AutoValidationAop.php
        ├── IValidator.php
        ├── Validator.php
        └── ValidatorHelper.php
    ├── Worker.php
    └── functions.php


/config/config.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | return [
 6 |     'ignoreNamespace'   => [
 7 |         'Imi\Components\*',
 8 |     ],
 9 | ];
10 | 


--------------------------------------------------------------------------------
/src/Aop/AfterReturningJoinPoint.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop;
 6 | 
 7 | class AfterReturningJoinPoint extends JoinPoint
 8 | {
 9 |     /**
10 |      * 返回值
11 |      */
12 |     private mixed $returnValue;
13 | 
14 |     /**
15 |      * 设置返回值
16 |      */
17 |     public function setReturnValue(mixed $value): void
18 |     {
19 |         $this->returnValue = $value;
20 |     }
21 | 
22 |     /**
23 |      * 获取返回值
24 |      */
25 |     public function getReturnValue(): mixed
26 |     {
27 |         return $this->returnValue;
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Aop/AfterThrowingJoinPoint.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop;
 6 | 
 7 | class AfterThrowingJoinPoint extends JoinPoint
 8 | {
 9 |     /**
10 |      * 是否取消抛出异常.
11 |      */
12 |     private bool $isCancelThrow = false;
13 | 
14 |     public function __construct(string $type, string $method, array &$args, object $target,
15 |         /**
16 |          * 异常.
17 |          */
18 |         private readonly ?\Throwable $throwable)
19 |     {
20 |         parent::__construct($type, $method, $args, $target);
21 |     }
22 | 
23 |     /**
24 |      * 获取异常.
25 |      */
26 |     public function getThrowable(): \Throwable
27 |     {
28 |         return $this->throwable;
29 |     }
30 | 
31 |     /**
32 |      * 取消抛出异常.
33 |      *
34 |      * @param bool $isCancelThrow 是否取消，默认为true
35 |      */
36 |     public function cancelThrow(bool $isCancelThrow = true): void
37 |     {
38 |         $this->isCancelThrow = $isCancelThrow;
39 |     }
40 | 
41 |     /**
42 |      * 是否取消抛出异常.
43 |      */
44 |     public function isCancelThrow(): bool
45 |     {
46 |         return $this->isCancelThrow;
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/After.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 后置操作注解.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD)]
13 | class After extends Base
14 | {
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/AfterReturning.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 在After之后、return之前触发.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD)]
13 | class AfterReturning extends Base
14 | {
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/AfterThrowing.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 在异常时通知.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD)]
13 | class AfterThrowing extends Base
14 | {
15 |     public function __construct(
16 |         /**
17 |          * 允许捕获的异常类列表.
18 |          */
19 |         public array $allow = [],
20 |         /**
21 |          * 不允许捕获的异常类列表.
22 |          */
23 |         public array $deny = []
24 |     ) {
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/Around.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 环绕通知.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD)]
13 | class Around extends Base
14 | {
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/Aspect.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 切面注解.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_CLASS)]
13 | class Aspect extends Base
14 | {
15 |     public function __construct(
16 |         /**
17 |          * 优先级，越大越先执行.
18 |          */
19 |         public int $priority = 0
20 |     ) {
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/BaseInjectValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * 注入值注解基类.
12 |  */
13 | #[Parser(className: \Imi\Bean\Parser\BeanParser::class)]
14 | abstract class BaseInjectValue extends Base
15 | {
16 |     /**
17 |      * 获取注入值的真实值
18 |      */
19 |     abstract public function getRealValue(): mixed;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/Before.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 前置操作注解.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD)]
13 | class Before extends Base
14 | {
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/CallableValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Inherit;
 8 | 
 9 | /**
10 |  * 回调注解，返回该回调的返回值
11 |  */
12 | #[\Attribute(\Attribute::TARGET_PROPERTY)]
13 | #[Inherit]
14 | class CallableValue extends BaseInjectValue
15 | {
16 |     public function __construct(
17 |         /**
18 |          * 回调.
19 |          *
20 |          * @var callable
21 |          */
22 |         public $callable = null
23 |     ) {
24 |     }
25 | 
26 |     /**
27 |      * {@inheritDoc}
28 |      */
29 |     public function getRealValue(): mixed
30 |     {
31 |         return ($this->callable)();
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/ConstValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Inherit;
 8 | 
 9 | /**
10 |  * 从常量中读取值
11 |  *
12 |  * 支持在注解中为属性动态赋值
13 |  */
14 | #[\Attribute(\Attribute::TARGET_PROPERTY)]
15 | #[Inherit]
16 | class ConstValue extends BaseInjectValue
17 | {
18 |     public function __construct(
19 |         /**
20 |          * 常量名.
21 |          */
22 |         public string $name = '',
23 |         /**
24 |          * 常量不存在时，返回的默认值
25 |          *
26 |          * @var mixed
27 |          */
28 |         public $default = null
29 |     ) {
30 |     }
31 | 
32 |     /**
33 |      * {@inheritDoc}
34 |      */
35 |     public function getRealValue(): mixed
36 |     {
37 |         return \defined($this->name) ? \constant($this->name) : $this->default;
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/FilterArg.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 过滤方法参数注解.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
13 | class FilterArg extends Base
14 | {
15 |     public function __construct(
16 |         /**
17 |          * 参数名.
18 |          */
19 |         public ?string $name = null,
20 |         /**
21 |          * 过滤器.
22 |          *
23 |          * @var ?callable
24 |          */
25 |         public $filter = null
26 |     ) {
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/Inject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\App;
 8 | use Imi\Bean\Annotation\Inherit;
 9 | 
10 | /**
11 |  * 对象注入
12 |  * 使用：App::getBean().
13 |  */
14 | #[\Attribute(\Attribute::TARGET_PROPERTY)]
15 | #[Inherit]
16 | class Inject extends BaseInjectValue
17 | {
18 |     public function __construct(
19 |         /**
20 |          * Bean名称或类名.
21 |          */
22 |         public string $name = '',
23 |         /**
24 |          * Bean实例化参数.
25 |          */
26 |         public array $args = []
27 |     ) {
28 |     }
29 | 
30 |     /**
31 |      * {@inheritDoc}
32 |      */
33 |     public function getRealValue(): mixed
34 |     {
35 |         return App::getBean($this->name, ...$this->args);
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/InjectArg.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 方法参数注入.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
13 | class InjectArg extends Base
14 | {
15 |     public function __construct(
16 |         /**
17 |          * 参数名.
18 |          */
19 |         public string $name = '',
20 |         /**
21 |          * 注入的值
22 |          *
23 |          * @var mixed
24 |          */
25 |         public $value = null
26 |     ) {
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/PointCut.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Aop\PointCutType;
 8 | use Imi\Bean\Annotation\Base;
 9 | 
10 | /**
11 |  * 切入点.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_METHOD)]
14 | class PointCut extends Base
15 | {
16 |     public function __construct(
17 |         /**
18 |          * 切入点类型，PointCutType::XXX.
19 |          */
20 |         public int $type = PointCutType::METHOD,
21 |         /**
22 |          * 允许的切入点.
23 |          */
24 |         public array $allow = [],
25 |         /**
26 |          * 不允许的切入点，即使包含中有的，也可以被排除.
27 |          */
28 |         public array $deny = [],
29 |         /**
30 |          * 优先级，越大越先执行.
31 |          * 为 null 时使用 Aspect 设置.
32 |          */
33 |         public ?int $priority = null
34 |     ) {
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Aop/Annotation/RequestInject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Inherit;
 8 | use Imi\RequestContext;
 9 | 
10 | /**
11 |  * 属性注入
12 |  * 使用：RequestContext::getBean().
13 |  */
14 | #[\Attribute(\Attribute::TARGET_PROPERTY)]
15 | #[Inherit]
16 | class RequestInject extends BaseInjectValue
17 | {
18 |     public function __construct(
19 |         /**
20 |          * Bean名称或类名.
21 |          */
22 |         public string $name = '',
23 |         /**
24 |          * Bean实例化参数.
25 |          */
26 |         public array $args = []
27 |     ) {
28 |     }
29 | 
30 |     /**
31 |      * {@inheritDoc}
32 |      */
33 |     public function getRealValue(): mixed
34 |     {
35 |         return RequestContext::getBean($this->name, ...$this->args);
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Aop/Aop/FilterArgAop.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Aop;
 6 | 
 7 | use Imi\Aop\Annotation\Aspect;
 8 | use Imi\Aop\Annotation\Before;
 9 | use Imi\Aop\Annotation\FilterArg;
10 | use Imi\Aop\Annotation\PointCut;
11 | use Imi\Aop\JoinPoint;
12 | use Imi\Bean\Annotation\AnnotationManager;
13 | use Imi\Bean\BeanFactory;
14 | use Imi\Util\ClassObject;
15 | 
16 | #[Aspect]
17 | class FilterArgAop
18 | {
19 |     /**
20 |      * 过滤方法参数.
21 |      */
22 |     #[PointCut(type: \Imi\Aop\PointCutType::ANNOTATION, allow: [\Imi\Aop\Annotation\FilterArg::class])]
23 |     #[Before]
24 |     public function parse(JoinPoint $joinPoint): void
25 |     {
26 |         $class = BeanFactory::getObjectClass($joinPoint->getTarget());
27 |         $method = $joinPoint->getMethod();
28 |         /** @var FilterArg[] $filterArgs */
29 |         $filterArgs = AnnotationManager::getMethodAnnotations($class, $method, FilterArg::class);
30 |         $args = ClassObject::convertArgsToKV($class, $method, $joinPoint->getArgs());
31 | 
32 |         foreach ($filterArgs as $filterArg)
33 |         {
34 |             $name = $filterArg->name;
35 |             $args[$name] = ($filterArg->filter)($args[$name]);
36 |         }
37 | 
38 |         $args = array_values($args);
39 | 
40 |         $joinPoint->setArgs($args);
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Aop/AroundJoinPoint.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop;
 6 | 
 7 | class AroundJoinPoint extends JoinPoint
 8 | {
 9 |     /**
10 |      * process调用的方法.
11 |      *
12 |      * @var callable
13 |      */
14 |     private $nextProceed;
15 | 
16 |     public function __construct(string $type, string $method, array &$args, object $target, callable $nextProceed)
17 |     {
18 |         parent::__construct($type, $method, $args, $target);
19 |         $this->nextProceed = $nextProceed;
20 |     }
21 | 
22 |     /**
23 |      * 调用下一个方法.
24 |      */
25 |     public function &proceed(?array $args = null, bool $returnsReference = false): mixed
26 |     {
27 |         if (null === $args)
28 |         {
29 |             $args = $this->getArgs();
30 |         }
31 |         if ($returnsReference)
32 |         {
33 |             $result = &($this->nextProceed)($args, $returnsReference);
34 |         }
35 |         else
36 |         {
37 |             $result = ($this->nextProceed)($args, $returnsReference);
38 |         }
39 | 
40 |         $this->args = $args;
41 | 
42 |         return $result;
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Aop/Listener/BuildRuntimeListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Listener;
 6 | 
 7 | use Imi\Aop\AopManager;
 8 | use Imi\Config;
 9 | use Imi\Event\IEventListener;
10 | 
11 | class BuildRuntimeListener implements IEventListener
12 | {
13 |     /**
14 |      * @param \Imi\Core\Runtime\Event\BuildRuntimeInfoEvent $e
15 |      */
16 |     public function handle(\Imi\Event\Contract\IEvent $e): void
17 |     {
18 |         if (!Config::get('@app.imi.runtime.aop', true))
19 |         {
20 |             return;
21 |         }
22 |         $e->data['aop'] = [
23 |             'cache'             => AopManager::getArrayCache(),
24 |             'dynamicRulesCache' => AopManager::getDynamicRulesCache(),
25 |         ];
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Aop/Listener/LoadRuntimeListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Listener;
 6 | 
 7 | use Imi\Aop\AopManager;
 8 | use Imi\Config;
 9 | use Imi\Event\IEventListener;
10 | 
11 | class LoadRuntimeListener implements IEventListener
12 | {
13 |     /**
14 |      * @param \Imi\Core\Runtime\Event\LoadRuntimeInfoEvent $e
15 |      */
16 |     public function handle(\Imi\Event\Contract\IEvent $e): void
17 |     {
18 |         if (!Config::get('@app.imi.runtime.aop', true))
19 |         {
20 |             return;
21 |         }
22 |         $data = $e->data['aop'] ?? [];
23 |         if ((bool) ($cache = ($data['cache'] ?? null)) | (bool) ($dynamicRulesCache = ($data['dynamicRulesCache'] ?? null)))
24 |         {
25 |             AopManager::clear();
26 |             if ($cache)
27 |             {
28 |                 AopManager::setArrayCache($cache);
29 |             }
30 |             if ($dynamicRulesCache)
31 |             {
32 |                 AopManager::setDynamicRulesCache($dynamicRulesCache);
33 |             }
34 |         }
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Aop/Model/AopItem.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop\Model;
 6 | 
 7 | class AopItem
 8 | {
 9 |     /**
10 |      * @var callable
11 |      */
12 |     private $callback;
13 | 
14 |     public function __construct(private readonly string $class, private readonly string $methodRule, callable $callback, private readonly int $priority = 0, private readonly array $options = [])
15 |     {
16 |         $this->callback = $callback;
17 |     }
18 | 
19 |     public function getClass(): string
20 |     {
21 |         return $this->class;
22 |     }
23 | 
24 |     public function getMethodRule(): string
25 |     {
26 |         return $this->methodRule;
27 |     }
28 | 
29 |     public function getCallback(): callable
30 |     {
31 |         return $this->callback;
32 |     }
33 | 
34 |     public function getPriority(): int
35 |     {
36 |         return $this->priority;
37 |     }
38 | 
39 |     public function getOptions(): array
40 |     {
41 |         return $this->options;
42 |     }
43 | 
44 |     public function getClassMethodRule(): string
45 |     {
46 |         return $this->class . '::' . $this->methodRule;
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Aop/PointCutType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Aop;
 6 | 
 7 | /**
 8 |  * 切入点类型.
 9 |  */
10 | class PointCutType
11 | {
12 |     use \Imi\Util\Traits\TStaticClass;
13 | 
14 |     /**
15 |      * 方法.
16 |      */
17 |     public const METHOD = 1;
18 | 
19 |     /**
20 |      * 带有注解的方法.
21 |      */
22 |     public const ANNOTATION = 2;
23 | 
24 |     /**
25 |      * 构造方法.
26 |      */
27 |     public const CONSTRUCT = 3;
28 | 
29 |     /**
30 |      * 带有注解的类的构造方法.
31 |      */
32 |     public const ANNOTATION_CONSTRUCT = 4;
33 | }
34 | 


--------------------------------------------------------------------------------
/src/AppContexts.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi;
 6 | 
 7 | class AppContexts
 8 | {
 9 |     use \Imi\Util\Traits\TStaticClass;
10 | 
11 |     /**
12 |      * 应用命名空间根所在路径.
13 |      */
14 |     public const APP_PATH = 'app_path';
15 | 
16 |     /**
17 |      * 应用命名空间根所在物理路径.
18 |      */
19 |     public const APP_PATH_PHYSICS = 'app_path_physics';
20 | 
21 |     /**
22 |      * 事件调度器.
23 |      */
24 |     public const EVENT_DISPATCHER = 'event_dispatcher';
25 | 
26 |     /**
27 |      * 事件监听提供者.
28 |      */
29 |     public const EVENT_LISTENER_PROVIDER = 'event_listener_provider';
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Async/Annotation/Async.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Async\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 异步执行.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD)]
13 | class Async extends Base
14 | {
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Async/Annotation/Defer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Async\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 延后执行.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD)]
13 | class Defer extends Base
14 | {
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Async/Annotation/DeferAsync.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Async\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 延后异步执行.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD)]
13 | class DeferAsync extends Base
14 | {
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Async/AsyncResult.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Async;
 6 | 
 7 | use Imi\Async\Contract\IAsyncResult;
 8 | use Imi\Log\Log;
 9 | 
10 | class AsyncResult implements IAsyncResult
11 | {
12 |     private bool $isGeted = false;
13 | 
14 |     public function __construct(private mixed $result = null, private readonly bool $isException = false)
15 |     {
16 |     }
17 | 
18 |     public function __destruct()
19 |     {
20 |         if (!$this->isGeted && $this->isException)
21 |         {
22 |             Log::error($this->result);
23 |         }
24 |     }
25 | 
26 |     /**
27 |      * {@inheritDoc}
28 |      */
29 |     public function get(?float $timeout = null): mixed
30 |     {
31 |         $this->isGeted = true;
32 |         $result = $this->result;
33 |         if ($this->isException)
34 |         {
35 |             throw $result;
36 |         }
37 |         if ($result instanceof IAsyncResult)
38 |         {
39 |             return $result->get($timeout);
40 |         }
41 | 
42 |         return $result;
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Async/Contract/IAsyncHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Async\Contract;
 6 | 
 7 | /**
 8 |  * 异步执行器.
 9 |  */
10 | interface IAsyncHandler
11 | {
12 |     /**
13 |      * 执行.
14 |      */
15 |     public function exec(callable $callable): IAsyncResult;
16 | 
17 |     /**
18 |      * 延后执行.
19 |      */
20 |     public function defer(callable $callable): IAsyncResult;
21 | 
22 |     /**
23 |      * 延后异步执行.
24 |      */
25 |     public function deferAsync(callable $callable): IAsyncResult;
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Async/Contract/IAsyncResult.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Async\Contract;
 6 | 
 7 | /**
 8 |  * 异步执行结果.
 9 |  */
10 | interface IAsyncResult
11 | {
12 |     /**
13 |      * 获取异步返回结果.
14 |      *
15 |      * 默认不超时无限等待，超时则会抛出异常
16 |      */
17 |     public function get(?float $timeout = null): mixed;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Async/Exception/AsyncTimeoutException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Async\Exception;
 6 | 
 7 | /**
 8 |  * 异步超时异常.
 9 |  */
10 | class AsyncTimeoutException extends \Exception
11 | {
12 |     public function __construct(string $message = 'Async timeout', int $code = 0, ?\Throwable $previous = null)
13 |     {
14 |         parent::__construct($message, $code, $previous);
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Base.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation;
 6 | 
 7 | use Imi\Util\ClassObject;
 8 | 
 9 | /**
10 |  * 注解基类.
11 |  */
12 | abstract class Base implements \JsonSerializable
13 | {
14 |     /**
15 |      * 注解别名.
16 |      *
17 |      * @var string|string[]|null
18 |      */
19 |     protected string|array|null $__alias = null;
20 | 
21 |     /**
22 |      * @return string|string[]|null
23 |      */
24 |     public function getAlias(): string|array|null
25 |     {
26 |         return $this->__alias;
27 |     }
28 | 
29 |     /**
30 |      * {@inheritDoc}
31 |      */
32 |     public function jsonSerialize(): mixed
33 |     {
34 |         return $this;
35 |     }
36 | 
37 |     /**
38 |      * 将当前对象作为数组返回.
39 |      */
40 |     public function toArray(): array
41 |     {
42 |         return ClassObject::getPublicProperties($this);
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Bean.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation;
 6 | 
 7 | /**
 8 |  * Bean.
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
11 | #[\Imi\Bean\Annotation\Parser(className: \Imi\Bean\Parser\BeanParser::class)]
12 | class Bean extends Base
13 | {
14 |     /**
15 |      * 单例模式.
16 |      */
17 |     public const INSTANCE_TYPE_SINGLETON = 'singleton';
18 |     /**
19 |      * 每次实例化.
20 |      */
21 |     public const INSTANCE_TYPE_EACH_NEW = 'eachNew';
22 | 
23 |     public function __construct(
24 |         /**
25 |          * Bean名称，留空则为当前类名（包含完整命名空间）.
26 |          */
27 |         public ?string $name = null,
28 |         /**
29 |          * 实例化类型，默认为单例模式.
30 |          */
31 |         public string $instanceType = self::INSTANCE_TYPE_SINGLETON,
32 |         /**
33 |          * 是否启用递归特性.
34 |          */
35 |         public bool $recursion = false,
36 |         /**
37 |          * 限制生效的环境，为 null 时则不限制.
38 |          *
39 |          * @var string|array|null
40 |          */
41 |         public $env = null
42 |     ) {
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Callback.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation;
 6 | 
 7 | use Imi\Aop\Annotation\BaseInjectValue;
 8 | 
 9 | /**
10 |  * 回调注解.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_PROPERTY)]
13 | #[\Imi\Bean\Annotation\Inherit]
14 | class Callback extends BaseInjectValue
15 | {
16 |     public function __construct(
17 |         /**
18 |          * 类名，或者传入对象
19 |          *
20 |          * @var string|object
21 |          */
22 |         public $class = null,
23 |         /**
24 |          * 方法名.
25 |          */
26 |         public string $method = ''
27 |     ) {
28 |     }
29 | 
30 |     /**
31 |      * 获取注入值的真实值
32 |      */
33 |     public function getRealValue(): mixed
34 |     {
35 |         return [$this->class, $this->method];
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/ClassEventListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation;
 6 | 
 7 | /**
 8 |  * 类事件监听.
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
11 | #[\Imi\Bean\Annotation\Parser(className: \Imi\Bean\Parser\ClassEventParser::class)]
12 | class ClassEventListener extends Base
13 | {
14 |     public function __construct(
15 |         /**
16 |          * 类名.
17 |          */
18 |         public string $className = '',
19 |         /**
20 |          * 事件名.
21 |          */
22 |         public string $eventName = '',
23 |         /**
24 |          * 优先级，越大越先执行.
25 |          */
26 |         public int $priority = 0
27 |     ) {
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Inherit.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation;
 6 | 
 7 | /**
 8 |  * 指定允许继承父类的指定注解.
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY | \Attribute::TARGET_CLASS_CONSTANT)]
11 | class Inherit extends Base
12 | {
13 |     public function __construct(
14 |         /**
15 |          * 允许的注解类，为 null 则不限制，支持字符串或数组.
16 |          *
17 |          * @var string|string[]|null
18 |          */
19 |         public $annotation = null
20 |     ) {
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Listener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation;
 6 | 
 7 | /**
 8 |  * 类事件监听.
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
11 | #[\Imi\Bean\Annotation\Parser(className: \Imi\Bean\Parser\ListenerParser::class)]
12 | class Listener extends Base
13 | {
14 |     public function __construct(
15 |         /**
16 |          * 事件名.
17 |          */
18 |         public string $eventName = '',
19 |         /**
20 |          * 优先级，越大越先执行.
21 |          */
22 |         public int $priority = 0,
23 |         /**
24 |          * 事件仅触发一次
25 |          */
26 |         public bool $one = false
27 |     ) {
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Model/ClassAnnotationRelation.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation\Model;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | class ClassAnnotationRelation implements IAnnotationRelation
10 | {
11 |     public function __construct(
12 |         /**
13 |          * 类名.
14 |          */
15 |         private readonly string $class,
16 |         /**
17 |          * 注解.
18 |          */
19 |         private readonly ?Base $annotation
20 |     ) {
21 |     }
22 | 
23 |     /**
24 |      * {@inheritDoc}
25 |      */
26 |     public function getClass(): string
27 |     {
28 |         return $this->class;
29 |     }
30 | 
31 |     /**
32 |      * {@inheritDoc}
33 |      */
34 |     public function getAnnotation(): Base
35 |     {
36 |         return $this->annotation;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Model/ConstantAnnotationRelation.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation\Model;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | class ConstantAnnotationRelation implements IAnnotationRelation
10 | {
11 |     public function __construct(
12 |         /**
13 |          * 类名.
14 |          */
15 |         private readonly string $class,
16 |         /**
17 |          * 常量名.
18 |          */
19 |         private readonly string $constant,
20 |         /**
21 |          * 注解.
22 |          */
23 |         private readonly ?Base $annotation
24 |     ) {
25 |     }
26 | 
27 |     /**
28 |      * {@inheritDoc}
29 |      */
30 |     public function getClass(): string
31 |     {
32 |         return $this->class;
33 |     }
34 | 
35 |     /**
36 |      * {@inheritDoc}
37 |      */
38 |     public function getAnnotation(): Base
39 |     {
40 |         return $this->annotation;
41 |     }
42 | 
43 |     /**
44 |      * Get 常量名.
45 |      */
46 |     public function getConstant(): string
47 |     {
48 |         return $this->constant;
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Model/IAnnotationRelation.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation\Model;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | interface IAnnotationRelation
10 | {
11 |     /**
12 |      * Get 类名.
13 |      */
14 |     public function getClass(): string;
15 | 
16 |     /**
17 |      * Get 注解.
18 |      */
19 |     public function getAnnotation(): Base;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Model/MethodAnnotationRelation.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation\Model;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | class MethodAnnotationRelation implements IAnnotationRelation
10 | {
11 |     public function __construct(
12 |         /**
13 |          * 类名.
14 |          */
15 |         private readonly string $class,
16 |         /**
17 |          * 方法名.
18 |          */
19 |         private readonly string $method,
20 |         /**
21 |          * 注解.
22 |          */
23 |         private readonly ?Base $annotation
24 |     ) {
25 |     }
26 | 
27 |     /**
28 |      * {@inheritDoc}
29 |      */
30 |     public function getClass(): string
31 |     {
32 |         return $this->class;
33 |     }
34 | 
35 |     /**
36 |      * {@inheritDoc}
37 |      */
38 |     public function getAnnotation(): Base
39 |     {
40 |         return $this->annotation;
41 |     }
42 | 
43 |     /**
44 |      * Get 方法名.
45 |      */
46 |     public function getMethod(): string
47 |     {
48 |         return $this->method;
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Model/PropertyAnnotationRelation.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation\Model;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | class PropertyAnnotationRelation implements IAnnotationRelation
10 | {
11 |     public function __construct(
12 |         /**
13 |          * 类名.
14 |          */
15 |         private readonly string $class,
16 |         /**
17 |          * 属性名.
18 |          */
19 |         private readonly string $property,
20 |         /**
21 |          * 注解.
22 |          */
23 |         private readonly ?Base $annotation
24 |     ) {
25 |     }
26 | 
27 |     /**
28 |      * {@inheritDoc}
29 |      */
30 |     public function getClass(): string
31 |     {
32 |         return $this->class;
33 |     }
34 | 
35 |     /**
36 |      * {@inheritDoc}
37 |      */
38 |     public function getAnnotation(): Base
39 |     {
40 |         return $this->annotation;
41 |     }
42 | 
43 |     /**
44 |      * Get 属性名.
45 |      */
46 |     public function getProperty(): string
47 |     {
48 |         return $this->property;
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Parser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation;
 6 | 
 7 | /**
 8 |  * 指定注解类处理器.
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS)]
11 | class Parser extends Base
12 | {
13 |     public function __construct(
14 |         /**
15 |          * 处理器类名.
16 |          */
17 |         public string $className = ''
18 |     ) {
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Bean/Annotation/Partial.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Annotation;
 6 | 
 7 | /**
 8 |  * 局部类型（Partial）注解.
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
11 | #[\Imi\Bean\Annotation\Parser(className: \Imi\Bean\Parser\PartialParser::class)]
12 | class Partial extends Base
13 | {
14 |     public function __construct(
15 |         /**
16 |          * 注入类名.
17 |          */
18 |         public string $class = ''
19 |     ) {
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Bean/Exception/ContainerException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Exception;
 6 | 
 7 | use Psr\Container\ContainerExceptionInterface;
 8 | 
 9 | class ContainerException extends \Exception implements ContainerExceptionInterface
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Bean/Exception/NotFoundException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Exception;
 6 | 
 7 | use Psr\Container\NotFoundExceptionInterface;
 8 | 
 9 | class NotFoundException extends \Exception implements NotFoundExceptionInterface
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Bean/IBean.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean;
 6 | 
 7 | interface IBean
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Bean/Parser/BaseParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Parser;
 6 | 
 7 | use Imi\Util\Traits\TSingleton;
 8 | 
 9 | abstract class BaseParser implements IParser
10 | {
11 |     use TSingleton;
12 | 
13 |     /**
14 |      * 注解目标-类.
15 |      */
16 |     public const TARGET_CLASS = 'class';
17 | 
18 |     /**
19 |      * 注解目标-属性.
20 |      */
21 |     public const TARGET_PROPERTY = 'property';
22 | 
23 |     /**
24 |      * 注解目标-方法.
25 |      */
26 |     public const TARGET_METHOD = 'method';
27 | 
28 |     /**
29 |      * 注解目标-常量.
30 |      */
31 |     public const TARGET_CONST = 'const';
32 | 
33 |     /**
34 |      * 是否子类作为单独实例.
35 |      */
36 |     protected static function isChildClassSingleton(): bool
37 |     {
38 |         return true;
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Bean/Parser/ClassEventParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Parser;
 6 | 
 7 | use Imi\Event\ClassEventManager;
 8 | 
 9 | class ClassEventParser extends BaseParser
10 | {
11 |     /**
12 |      * {@inheritDoc}
13 |      */
14 |     public function parse(\Imi\Bean\Annotation\Base $annotation, string $className, string $target, string $targetName): void
15 |     {
16 |         if ($annotation instanceof \Imi\Bean\Annotation\ClassEventListener)
17 |         {
18 |             ClassEventManager::add($annotation->className, $annotation->eventName, $className, $annotation->priority);
19 |         }
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Bean/Parser/IParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Parser;
 6 | 
 7 | interface IParser
 8 | {
 9 |     /**
10 |      * 处理方法.
11 |      *
12 |      * @param \Imi\Bean\Annotation\Base $annotation 注解类
13 |      * @param string                    $className  类名
14 |      * @param string                    $target     注解目标类型（类/属性/方法）
15 |      * @param string                    $targetName 注解目标名称
16 |      */
17 |     public function parse(\Imi\Bean\Annotation\Base $annotation, string $className, string $target, string $targetName): void;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Bean/Parser/ListenerParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Parser;
 6 | 
 7 | use Imi\App;
 8 | use Imi\Event\Contract\IEvent;
 9 | use Imi\Event\Event;
10 | use Imi\Event\EventManager;
11 | 
12 | class ListenerParser extends BaseParser
13 | {
14 |     /**
15 |      * {@inheritDoc}
16 |      */
17 |     public function parse(\Imi\Bean\Annotation\Base $annotation, string $className, string $target, string $targetName): void
18 |     {
19 |         if ($annotation instanceof \Imi\Bean\Annotation\Listener)
20 |         {
21 |             $eventName = $annotation->eventName;
22 |             $priority = $annotation->priority;
23 |             $one = $annotation->one;
24 |             EventManager::add($eventName, $className, $priority, $one);
25 |             if ($one)
26 |             {
27 |                 Event::one($eventName, static fn (IEvent $e) => App::newInstance($className)->handle($e), $priority);
28 |             }
29 |             else
30 |             {
31 |                 Event::on($eventName, static fn (IEvent $e) => App::newInstance($className)->handle($e), $priority);
32 |             }
33 |         }
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Bean/Parser/NullParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Parser;
 6 | 
 7 | /**
 8 |  * 不做操作的空Parser.
 9 |  */
10 | class NullParser extends BaseParser
11 | {
12 |     /**
13 |      * {@inheritDoc}
14 |      */
15 |     public function parse(\Imi\Bean\Annotation\Base $annotation, string $className, string $target, string $targetName): void
16 |     {
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Bean/Parser/PartialParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Parser;
 6 | 
 7 | use Imi\Bean\PartialManager;
 8 | 
 9 | class PartialParser extends BaseParser
10 | {
11 |     /**
12 |      * {@inheritDoc}
13 |      *
14 |      * @param \Imi\Bean\Annotation\Partial $annotation
15 |      */
16 |     public function parse(\Imi\Bean\Annotation\Base $annotation, string $className, string $target, string $targetName): void
17 |     {
18 |         // Partial 仅支持定义为 trait
19 |         if (!trait_exists($className, true))
20 |         {
21 |             return;
22 |         }
23 |         PartialManager::add($className, $annotation->class);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Bean/Traits/TAutoInject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Bean\Traits;
 6 | 
 7 | use Imi\Bean\BeanFactory;
 8 | use Imi\Bean\BeanProxy;
 9 | 
10 | /**
11 |  * 自动注入属性.
12 |  */
13 | trait TAutoInject
14 | {
15 |     public function __construct()
16 |     {
17 |         $this->__autoInject();
18 |     }
19 | 
20 |     /**
21 |      * 自动注入属性.
22 |      */
23 |     protected function __autoInject(): void
24 |     {
25 |         BeanProxy::injectProps($this, BeanFactory::getObjectClass($this));
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Cache/Annotation/CacheEvict.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cache\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 缓存驱逐注解.
11 |  *
12 |  * 方法体执行时，将指定缓存清除
13 |  */
14 | #[\Attribute(\Attribute::TARGET_METHOD)]
15 | class CacheEvict extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 缓存器名称；为null则使用默认缓存器.
20 |          */
21 |         public ?string $name = null,
22 |         /**
23 |          * 缓存键名；支持{id}、{data.name}形式，代入参数；支持{:args}代入所有方法参数的 hash 值；如果为空，则使用类名+方法名+全部参数，序列化后hash.
24 |          */
25 |         public string $key = '',
26 |         /**
27 |          * 在方法执行前删除缓存，默认为false.
28 |          */
29 |         public bool $beforeInvocation = false,
30 |         /**
31 |          * 可以指定 hash 方法，默认为：md5.
32 |          */
33 |         public string $hashMethod = 'md5'
34 |     ) {
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Cache/Annotation/CachePut.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cache\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 缓存注解.
11 |  *
12 |  * 方法体执行后，将返回值存入缓存
13 |  */
14 | #[\Attribute(\Attribute::TARGET_METHOD)]
15 | class CachePut extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 缓存器名称；为null则使用默认缓存器.
20 |          */
21 |         public ?string $name = null,
22 |         /**
23 |          * 缓存键名；支持{id}、{data.name}形式，代入参数；支持{:args}代入所有方法参数的 hash 值；如果为空，则使用类名+方法名+全部参数，序列化后hash.
24 |          */
25 |         public string $key = '',
26 |         /**
27 |          * 写入缓存的值；默认为null时，返回值作为缓存的值；如果为字符串时（如：a.b），则将返回值作为数组或对象，取value->a->b下的值
28 |          */
29 |         public ?string $value = null,
30 |         /**
31 |          * 缓存超时时间，单位：秒.
32 |          */
33 |         public ?int $ttl = null,
34 |         /**
35 |          * 可以指定 hash 方法，默认为：md5.
36 |          */
37 |         public string $hashMethod = 'md5'
38 |     ) {
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Cache/Annotation/Cacheable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cache\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Lock\Annotation\Lockable;
 9 | 
10 | /**
11 |  * 缓存注解.
12 |  *
13 |  * 调用方法前检测是否存在缓存，如果存在直接返回；不存在则执行方法体，然后将返回值存入缓存
14 |  */
15 | #[\Attribute(\Attribute::TARGET_METHOD)]
16 | class Cacheable extends Base
17 | {
18 |     public function __construct(
19 |         /**
20 |          * 缓存器名称；为null则使用默认缓存器.
21 |          */
22 |         public ?string $name = null,
23 |         /**
24 |          * 缓存键名；支持{id}、{data.name}形式，代入参数；支持{:args}代入所有方法参数的 hash 值；如果为空，则使用类名+方法名+全部参数，序列化后hash.
25 |          */
26 |         public string $key = '',
27 |         /**
28 |          * 缓存超时时间，单位：秒.
29 |          */
30 |         public ?int $ttl = null,
31 |         /**
32 |          * Lock 注解；在调用方法体前后加锁
33 |          */
34 |         public ?Lockable $lockable = null,
35 |         /**
36 |          * 防止缓存击穿；如果设为 true，会在获得锁后，尝试获取缓存，如果缓存存在则不再执行方法体；需要配合 $lockable 属性使用.
37 |          */
38 |         public bool $preventBreakdown = false,
39 |         /**
40 |          * 可以指定 hash 方法，默认为：md5.
41 |          */
42 |         public string $hashMethod = 'md5'
43 |     ) {
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Cache/CacheException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cache;
 6 | 
 7 | class CacheException extends \Exception implements \Psr\SimpleCache\CacheException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Cache/InvalidArgumentException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cache;
 6 | 
 7 | class InvalidArgumentException extends \InvalidArgumentException implements \Psr\SimpleCache\InvalidArgumentException
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Cli/Annotation/Argument.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * 参数注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Cli\Parser\ToolParser::class)]
15 | class Argument extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 参数名称.
20 |          */
21 |         public string $name = '',
22 |         /**
23 |          * 参数类型.
24 |          */
25 |         public ?string $type = null,
26 |         /**
27 |          * 默认值
28 |          *
29 |          * @var mixed
30 |          */
31 |         public $default = null,
32 |         /**
33 |          * 是否是必选参数.
34 |          */
35 |         public bool $required = false,
36 |         /**
37 |          * 注释.
38 |          */
39 |         public string $comments = '',
40 |         /**
41 |          * 将参数值绑定到指定名称的参数.
42 |          */
43 |         public string $to = ''
44 |     ) {
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Cli/Annotation/Command.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * 命令行注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Cli\Parser\ToolParser::class)]
15 | class Command extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 命令行名称.
20 |          */
21 |         public ?string $name = null,
22 |         /**
23 |          * 命令名分割符.
24 |          */
25 |         public string $separator = '/'
26 |     ) {
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Cli/Annotation/CommandAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * 命令行动作注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Cli\Parser\ToolParser::class)]
15 | class CommandAction extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 操作名称.
20 |          */
21 |         public ?string $name = null,
22 |         /**
23 |          * 操作描述.
24 |          */
25 |         public ?string $description = null,
26 |         /**
27 |          * 是否启用动态参数支持
28 |          */
29 |         public bool $dynamicOptions = false
30 |     ) {
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Cli/Annotation/Option.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * 可选项参数注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Cli\Parser\ToolParser::class)]
15 | class Option extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 参数名称.
20 |          */
21 |         public string $name = '',
22 |         /**
23 |          * 短名称.
24 |          */
25 |         public ?string $shortcut = null,
26 |         /**
27 |          * 参数类型.
28 |          */
29 |         public ?string $type = null,
30 |         /**
31 |          * 默认值
32 |          *
33 |          * @var mixed
34 |          */
35 |         public $default = null,
36 |         /**
37 |          * 是否是必选参数.
38 |          */
39 |         public bool $required = false,
40 |         /**
41 |          * 注释.
42 |          */
43 |         public string $comments = '',
44 |         /**
45 |          * 将参数值绑定到指定名称的参数.
46 |          */
47 |         public string $to = ''
48 |     ) {
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Cli/ArgType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli;
 6 | 
 7 | /**
 8 |  * 参数类型.
 9 |  */
10 | class ArgType
11 | {
12 |     use \Imi\Util\Traits\TStaticClass;
13 | 
14 |     public const STRING = 'string';
15 | 
16 |     public const INT = 'int';
17 | 
18 |     public const FLOAT = 'float';
19 | 
20 |     public const DOUBLE = 'float';
21 | 
22 |     public const BOOL = self::BOOLEAN;
23 | 
24 |     public const BOOLEAN = 'boolean';
25 | 
26 |     public const BOOL_NEGATABLE = self::BOOLEAN_NEGATABLE;
27 | 
28 |     public const BOOLEAN_NEGATABLE = 'boolean_negatable';
29 | 
30 |     public const ARRAY = 'array';
31 | 
32 |     public const ARRAY_EX = 'array_ex';
33 | 
34 |     public const MIXED = 'mixed';
35 | 
36 |     public static function isBooleanType(string $type): bool
37 |     {
38 |         return self::BOOLEAN === $type || self::BOOLEAN_NEGATABLE === $type || self::MIXED === $type;
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Cli/CliAppContexts.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli;
 6 | 
 7 | /**
 8 |  * 命令行相关的应用上下文名称定义.
 9 |  */
10 | class CliAppContexts
11 | {
12 |     use \Imi\Util\Traits\TStaticClass;
13 | 
14 |     /**
15 |      * 命令行名称.
16 |      */
17 |     public const COMMAND_NAME = 'command_name';
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Cli/Contract/BaseCommand.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli\Contract;
 6 | 
 7 | use Imi\Cli\ImiCommand;
 8 | use Symfony\Component\Console\Input\InputInterface;
 9 | use Symfony\Component\Console\Output\OutputInterface;
10 | 
11 | abstract class BaseCommand
12 | {
13 |     public function __construct(protected ImiCommand $command, protected InputInterface $input, protected OutputInterface $output)
14 |     {
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Cli/Event/CommandEvents.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli\Event;
 6 | 
 7 | use Imi\Util\Traits\TStaticClass;
 8 | 
 9 | final class CommandEvents
10 | {
11 |     use TStaticClass;
12 | 
13 |     /**
14 |      * 命令行执行前置事件.
15 |      */
16 |     public const BEFORE_COMMAND = 'imi.command.before';
17 | 
18 |     /**
19 |      * 命令行执行后置事件.
20 |      */
21 |     public const AFTER_COMMAND = 'imi.command.after';
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Cli/ImiConsoleOutput.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli;
 6 | 
 7 | use Symfony\Component\Console\Output\ConsoleOutput;
 8 | 
 9 | class ImiConsoleOutput extends ConsoleOutput
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Cli/Listener/BuildRuntimeListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli\Listener;
 6 | 
 7 | use Imi\Cli\CliManager;
 8 | use Imi\Config;
 9 | use Imi\Event\IEventListener;
10 | 
11 | class BuildRuntimeListener implements IEventListener
12 | {
13 |     /**
14 |      * @param \Imi\Core\Runtime\Event\BuildRuntimeInfoEvent $e
15 |      */
16 |     public function handle(\Imi\Event\Contract\IEvent $e): void
17 |     {
18 |         if (!Config::get('@app.imi.runtime.cli', true))
19 |         {
20 |             return;
21 |         }
22 |         $data = [];
23 |         $data['cli'] = CliManager::getMap();
24 |         $e->data['cli'] = $data;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Cli/Listener/LoadRuntimeListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli\Listener;
 6 | 
 7 | use Imi\Cli\CliManager;
 8 | use Imi\Config;
 9 | use Imi\Event\IEventListener;
10 | 
11 | class LoadRuntimeListener implements IEventListener
12 | {
13 |     /**
14 |      * @param \Imi\Core\Runtime\Event\LoadRuntimeInfoEvent $e
15 |      */
16 |     public function handle(\Imi\Event\Contract\IEvent $e): void
17 |     {
18 |         $config = Config::get('@app.imi.runtime', []);
19 |         if (!($config['cli'] ?? true))
20 |         {
21 |             return;
22 |         }
23 |         $data = $e->data['cli'] ?? [];
24 |         CliManager::setMap($data['cli'] ?? []);
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Cli/bin/imi-cli:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env php
2 | <?php
3 | (require dirname(__DIR__) . '/bootstrap.php')();
4 | 


--------------------------------------------------------------------------------
/src/Cli/bootstrap.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cli;
 6 | 
 7 | use Imi\App;
 8 | 
 9 | return static function (): void {
10 |     $path = null;
11 | 
12 |     if (\defined('IMI_IN_PHAR') && IMI_IN_PHAR)
13 |     {
14 |         $path = \dirname(__DIR__, 5);
15 |     }
16 |     elseif (!class_exists(\Imi\App::class))
17 |     {
18 |         (static function () use (&$path): void {
19 |             foreach ([
20 |                 $_SERVER['PWD'] ?? null,
21 |                 getcwd(),
22 |                 \dirname(__DIR__, 3),
23 |                 \dirname(__DIR__, 5), // 在非工作路径，使用绝对路径启动
24 |             ] as $path)
25 |             {
26 |                 if (!$path)
27 |                 {
28 |                     continue;
29 |                 }
30 |                 $fileName = $path . '/vendor/autoload.php';
31 |                 if (is_file($fileName))
32 |                 {
33 |                     require $fileName;
34 | 
35 |                     return;
36 |                 }
37 |             }
38 |             echo 'No file vendor/autoload.php', \PHP_EOL;
39 |             exit(255);
40 |         })();
41 |     }
42 | 
43 |     App::runApp($path ?? realpath(\dirname((string) $_SERVER['SCRIPT_NAME'], 2)), \Imi\Cli\CliApp::class);
44 | };
45 | 


--------------------------------------------------------------------------------
/src/Config/Annotation/ConfigValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Config\Annotation;
 6 | 
 7 | use Imi\Aop\Annotation\BaseInjectValue;
 8 | use Imi\Bean\Annotation\Inherit;
 9 | use Imi\Config;
10 | 
11 | /**
12 |  * 从配置中读取值
13 |  *
14 |  * 支持在注解中为属性动态赋值
15 |  */
16 | #[\Attribute(\Attribute::TARGET_PROPERTY)]
17 | #[Inherit]
18 | class ConfigValue extends BaseInjectValue
19 | {
20 |     public function __construct(
21 |         /**
22 |          * 配置名，支持@app、@currentServer等用法.
23 |          */
24 |         public string $name = '',
25 |         /**
26 |          * 配置不存在时，返回的默认值
27 |          *
28 |          * @var mixed
29 |          */
30 |         public $default = null
31 |     ) {
32 |     }
33 | 
34 |     /**
35 |      * {@inheritDoc}
36 |      */
37 |     public function getRealValue(): mixed
38 |     {
39 |         return Config::get($this->name, $this->default);
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Config/Annotation/EnvValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Config\Annotation;
 6 | 
 7 | use Imi\Aop\Annotation\BaseInjectValue;
 8 | use Imi\Bean\Annotation\Inherit;
 9 | 
10 | use function Imi\env;
11 | 
12 | /**
13 |  * 从环境变量中读取值
14 |  *
15 |  * 支持在注解中为属性动态赋值
16 |  */
17 | #[\Attribute(\Attribute::TARGET_PROPERTY)]
18 | #[Inherit]
19 | class EnvValue extends BaseInjectValue
20 | {
21 |     public function __construct(
22 |         /**
23 |          * 环境变量名称.
24 |          */
25 |         public string $name = '',
26 |         /**
27 |          * 配置不存在时，返回的默认值
28 |          *
29 |          * @var mixed
30 |          */
31 |         public $default = null
32 |     ) {
33 |     }
34 | 
35 |     /**
36 |      * {@inheritDoc}
37 |      */
38 |     public function getRealValue(): mixed
39 |     {
40 |         return env($this->name, $this->default);
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Contract/IWorker.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Contract;
 6 | 
 7 | interface IWorker
 8 | {
 9 |     /**
10 |      * 获取当前 worker 进程的 ID
11 |      * 注意，不是进程ID.
12 |      */
13 |     public function getWorkerId(): ?int;
14 | 
15 |     /**
16 |      * 获取 Worker 进程数量.
17 |      */
18 |     public function getWorkerNum(): int;
19 | 
20 |     /**
21 |      * 是否初始化完毕.
22 |      */
23 |     public function isInited(): bool;
24 | 
25 |     /**
26 |      * 初始化完毕.
27 |      */
28 |     public function inited(): void;
29 | 
30 |     /**
31 |      * 获取服务器 master 进程 PID.
32 |      */
33 |     public function getMasterPid(): int;
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Controller/HttpController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Controller;
 6 | 
 7 | /**
 8 |  * {@inheritdoc}
 9 |  */
10 | abstract class HttpController extends \Imi\Server\Http\Controller\HttpController
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Controller/README.md:
--------------------------------------------------------------------------------
1 | 本目录仅兼容 imi v1
2 | 


--------------------------------------------------------------------------------
/src/Controller/TcpController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Controller;
 6 | 
 7 | /**
 8 |  * {@inheritdoc}
 9 |  */
10 | abstract class TcpController extends \Imi\Server\TcpServer\Controller\TcpController
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Controller/UdpController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Controller;
 6 | 
 7 | /**
 8 |  * {@inheritdoc}
 9 |  */
10 | abstract class UdpController extends \Imi\Server\UdpServer\Controller\UdpController
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Controller/WebSocketController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Controller;
 6 | 
 7 | /**
 8 |  * {@inheritdoc}
 9 |  */
10 | abstract class WebSocketController extends \Imi\Server\WebSocket\Controller\WebSocketController
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Core/App/Contract/IApp.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\App\Contract;
 6 | 
 7 | /**
 8 |  * 应用类接口.
 9 |  */
10 | interface IApp
11 | {
12 |     /**
13 |      * 构造方法.
14 |      */
15 |     public function __construct(string $namespace);
16 | 
17 |     /**
18 |      * 加载配置.
19 |      */
20 |     public function loadConfig(): void;
21 | 
22 |     /**
23 |      * 加载入口.
24 |      */
25 |     public function loadMain(): void;
26 | 
27 |     /**
28 |      * 加载运行时.
29 |      */
30 |     public function loadRuntime(): int;
31 | 
32 |     /**
33 |      * 初始化.
34 |      */
35 |     public function init(): void;
36 | 
37 |     /**
38 |      * 获取应用类型.
39 |      */
40 |     public function getType(): string;
41 | 
42 |     /**
43 |      * 运行应用.
44 |      */
45 |     public function run(): void;
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Core/App/Enum/LoadRuntimeResult.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\App\Enum;
 6 | 
 7 | class LoadRuntimeResult
 8 | {
 9 |     use \Imi\Util\Traits\TStaticClass;
10 | 
11 |     public const NONE = 0;
12 | 
13 |     public const IMI_LOADED = 1;
14 | 
15 |     public const APP_LOADED = 2;
16 | 
17 |     public const ALL = self::IMI_LOADED + self::APP_LOADED;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Core/Component/ComponentManager.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Component;
 6 | 
 7 | use Imi\Main\Helper;
 8 | 
 9 | class ComponentManager
10 | {
11 |     use \Imi\Util\Traits\TStaticClass;
12 | 
13 |     private static array $components = [];
14 | 
15 |     public static function addComponent(string $name, string $namespace): void
16 |     {
17 |         self::$components[$name] = $namespace;
18 |         Helper::getMain($namespace, $name);
19 |     }
20 | 
21 |     public static function getComponents(): array
22 |     {
23 |         return self::$components;
24 |     }
25 | 
26 |     public static function setComponents(array $components): void
27 |     {
28 |         self::$components = $components;
29 |         foreach ($components as $name => $namespace)
30 |         {
31 |             Helper::getMain($namespace, $name);
32 |         }
33 |     }
34 | 
35 |     public static function has(string $name): bool
36 |     {
37 |         return isset(self::$components[$name]);
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Core/Component/Listener/BuildRuntimeListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Component\Listener;
 6 | 
 7 | use Imi\Config;
 8 | use Imi\Core\Component\ComponentManager;
 9 | use Imi\Event\IEventListener;
10 | 
11 | class BuildRuntimeListener implements IEventListener
12 | {
13 |     /**
14 |      * @param \Imi\Core\Runtime\Event\BuildRuntimeInfoEvent $e
15 |      */
16 |     public function handle(\Imi\Event\Contract\IEvent $e): void
17 |     {
18 |         if (!Config::get('@app.imi.runtime.component', true))
19 |         {
20 |             return;
21 |         }
22 |         $e->data['component'] = [
23 |             'components' => ComponentManager::getComponents(),
24 |         ];
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Core/Component/Listener/LoadRuntimeListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Component\Listener;
 6 | 
 7 | use Imi\Config;
 8 | use Imi\Core\Component\ComponentManager;
 9 | use Imi\Event\IEventListener;
10 | 
11 | class LoadRuntimeListener implements IEventListener
12 | {
13 |     /**
14 |      * @param \Imi\Core\Runtime\Event\LoadRuntimeInfoEvent $e
15 |      */
16 |     public function handle(\Imi\Event\Contract\IEvent $e): void
17 |     {
18 |         $config = Config::get('@app.imi.runtime', []);
19 |         if (!($config['component'] ?? true))
20 |         {
21 |             return;
22 |         }
23 |         ComponentManager::setComponents($e->data['component']['components'] ?? []);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Core/Context/ContextData.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Context;
 6 | 
 7 | class ContextData extends \ArrayObject
 8 | {
 9 |     protected \SplStack $deferCallbacks;
10 | 
11 |     public function __construct(mixed $input = [])
12 |     {
13 |         parent::__construct($input, self::ARRAY_AS_PROPS, \ArrayIterator::class);
14 |         $this->deferCallbacks = new \SplStack();
15 |     }
16 | 
17 |     /**
18 |      * 推迟执行，当协程释放时触发，先进后出.
19 |      */
20 |     public function defer(callable $callback): void
21 |     {
22 |         $this->deferCallbacks[] = $callback;
23 |     }
24 | 
25 |     /**
26 |      * 获取推迟执行任务栈.
27 |      */
28 |     public function getDeferCallbacks(): \SplStack
29 |     {
30 |         return $this->deferCallbacks;
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Core/Context/Contract/IContextManager.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Context\Contract;
 6 | 
 7 | use Imi\Core\Context\ContextData;
 8 | 
 9 | interface IContextManager
10 | {
11 |     /**
12 |      * 创建上下文.
13 |      */
14 |     public function create(string|int $id, array $data = []): ContextData;
15 | 
16 |     /**
17 |      * 销毁上下文.
18 |      */
19 |     public function destroy(string|int $id): bool;
20 | 
21 |     /**
22 |      * 获取上下文.
23 |      */
24 |     public function get(string|int $id, bool $autoCreate = false): ContextData;
25 | 
26 |     /**
27 |      * 上下文是否存在.
28 |      */
29 |     public function exists(string|int $id): bool;
30 | 
31 |     /**
32 |      * 获取当前上下文标识.
33 |      */
34 |     public function getCurrentId(): string|int;
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Core/Context/Exception/ContextExistsException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Context\Exception;
 6 | 
 7 | /**
 8 |  * 上下文已存在异常.
 9 |  */
10 | class ContextExistsException extends \Exception
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Core/Context/Exception/ContextNotFoundException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Context\Exception;
 6 | 
 7 | /**
 8 |  * 上下文不存在异常.
 9 |  */
10 | class ContextNotFoundException extends \Exception
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Core/Runtime/Contract/IRuntimeModeHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Runtime\Contract;
 6 | 
 7 | /**
 8 |  * 运行时模式处理器.
 9 |  */
10 | interface IRuntimeModeHandler
11 | {
12 |     /**
13 |      * 初始化.
14 |      */
15 |     public function init(): void;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Core/Runtime/Event/BuildRuntimeInfoEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Runtime\Event;
 6 | 
 7 | use Imi\Core\CoreEvents;
 8 | use Imi\Event\CommonEvent;
 9 | 
10 | class BuildRuntimeInfoEvent extends CommonEvent
11 | {
12 |     public function __construct(
13 |         public readonly string $cacheName,
14 |         public array $data,
15 |     ) {
16 |         $this->__eventName = CoreEvents::BUILD_RUNTIME;
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Core/Runtime/Event/LoadRuntimeInfoEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Runtime\Event;
 6 | 
 7 | use Imi\Core\CoreEvents;
 8 | use Imi\Event\CommonEvent;
 9 | 
10 | class LoadRuntimeInfoEvent extends CommonEvent
11 | {
12 |     public bool $success = false;
13 | 
14 |     public function __construct(
15 |         public readonly string $cacheName,
16 |         public array $data,
17 |         public readonly bool $onlyImi
18 |     ) {
19 |         $this->__eventName = CoreEvents::LOAD_RUNTIME_INFO;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Core/Runtime/Handler/DefaultRuntimeModeHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Runtime\Handler;
 6 | 
 7 | use Imi\App;
 8 | use Imi\Bean\Annotation\Bean;
 9 | use Imi\Core\CoreEvents;
10 | use Imi\Core\Runtime\Contract\IRuntimeModeHandler;
11 | use Imi\Core\Runtime\Event\BuildRuntimeInfoEvent;
12 | use Imi\Core\Runtime\Event\LoadRuntimeInfoEvent;
13 | use Imi\Event\Event;
14 | 
15 | #[Bean(name: 'DefaultRuntimeModeHandler')]
16 | class DefaultRuntimeModeHandler implements IRuntimeModeHandler
17 | {
18 |     /**
19 |      * {@inheritDoc}
20 |      */
21 |     public function init(): void
22 |     {
23 |         Event::on(CoreEvents::LOAD_RUNTIME_INFO, static fn (LoadRuntimeInfoEvent $e) => App::newInstance(\Imi\Cli\Listener\LoadRuntimeListener::class)->handle($e), 19940200);
24 |         Event::on(CoreEvents::BUILD_RUNTIME, static fn (BuildRuntimeInfoEvent $e) => App::newInstance(\Imi\Cli\Listener\BuildRuntimeListener::class)->handle($e), 19940200);
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Core/Runtime/Runtime.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Core\Runtime;
 6 | 
 7 | use Imi\App;
 8 | use Imi\Core\Runtime\Contract\IRuntimeModeHandler;
 9 | 
10 | class Runtime
11 | {
12 |     use \Imi\Util\Traits\TStaticClass;
13 | 
14 |     private static IRuntimeModeHandler $runtimeModeHandler;
15 | 
16 |     public static function setRuntimeModeHandler(string $class): IRuntimeModeHandler
17 |     {
18 |         return self::$runtimeModeHandler = App::getBean($class);
19 |     }
20 | 
21 |     public static function getRuntimeModeHandler(): IRuntimeModeHandler
22 |     {
23 |         return self::$runtimeModeHandler;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Cron/Consts/CronTaskType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Consts;
 6 | 
 7 | /**
 8 |  * 定时任务类型.
 9 |  */
10 | class CronTaskType
11 | {
12 |     use \Imi\Util\Traits\TStaticClass;
13 | 
14 |     public const CRON_PROCESS = 'cron_process';
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Cron/Consts/UniqueLevel.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Consts;
 6 | 
 7 | /**
 8 |  * 任务唯一性等级.
 9 |  */
10 | enum UniqueLevel: string
11 | {
12 |     /**
13 |      * 当前实例唯一
14 |      */
15 |     case Current = 'current';
16 | 
17 |     /**
18 |      * 所有实例唯一
19 |      */
20 |     case All = 'all';
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Cron/Contract/ICronTask.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Contract;
 6 | 
 7 | /**
 8 |  * 定时任务接口.
 9 |  */
10 | interface ICronTask
11 | {
12 |     /**
13 |      * 执行任务
14 |      */
15 |     public function run(string $id, mixed $data): void;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Cron/Contract/IScheduler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Contract;
 6 | 
 7 | use Imi\Cron\CronTask;
 8 | use Imi\Cron\Message\Result;
 9 | 
10 | /**
11 |  * 定时任务调度器接口.
12 |  */
13 | interface IScheduler
14 | {
15 |     /**
16 |      * 关闭.
17 |      */
18 |     public function close(): void;
19 | 
20 |     /**
21 |      * 遍历可运行的任务列表.
22 |      */
23 |     public function schedule(): \Generator;
24 | 
25 |     /**
26 |      * 执行任务
27 |      */
28 |     public function runTask(CronTask $task): void;
29 | 
30 |     /**
31 |      * 完成任务
32 |      */
33 |     public function completeTask(Result $result): void;
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Cron/Message/AddCron.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Message;
 6 | 
 7 | use Imi\Cron\Annotation\Cron;
 8 | 
 9 | class AddCron implements IMessage
10 | {
11 |     /**
12 |      * 定时任务注解.
13 |      */
14 |     public ?Cron $cronAnnotation = null;
15 | 
16 |     /**
17 |      * 任务
18 |      */
19 |     public string $task = '';
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Cron/Message/Clear.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Message;
 6 | 
 7 | class Clear implements IMessage
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Cron/Message/CommonMsg.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Message;
 6 | 
 7 | class CommonMsg implements IMessage
 8 | {
 9 |     /**
10 |      * 初始化.
11 |      */
12 |     public function __construct(
13 |         /**
14 |          * 从socket获取的返回信息.
15 |          */
16 |         protected mixed $response = []
17 |     ) {
18 |     }
19 | 
20 |     /**
21 |      * 设置返回信息.
22 |      */
23 |     public function setResponse(mixed $response = []): self
24 |     {
25 |         $this->response = $response;
26 | 
27 |         return $this;
28 |     }
29 | 
30 |     /**
31 |      * 获取返回信息.
32 |      */
33 |     public function getResponse(): mixed
34 |     {
35 |         return $this->response;
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Cron/Message/GetRealTasks.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Message;
 6 | 
 7 | class GetRealTasks implements IMessage
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Cron/Message/GetTask.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Message;
 6 | 
 7 | class GetTask implements IMessage
 8 | {
 9 |     /**
10 |      * 任务ID.
11 |      */
12 |     public string $id = '';
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Cron/Message/HasTask.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Message;
 6 | 
 7 | class HasTask implements IMessage
 8 | {
 9 |     /**
10 |      * 任务ID.
11 |      */
12 |     public string $id = '';
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Cron/Message/IMessage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Message;
 6 | 
 7 | interface IMessage
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Cron/Message/RemoveCron.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Message;
 6 | 
 7 | class RemoveCron implements IMessage
 8 | {
 9 |     /**
10 |      * 任务唯一ID.
11 |      */
12 |     public string $id = '';
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Cron/Traits/TWorkerReport.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Cron\Traits;
 6 | 
 7 | use Imi\Cron\Util\CronUtil;
 8 | 
 9 | /**
10 |  * 定时任务上报.
11 |  */
12 | trait TWorkerReport
13 | {
14 |     /**
15 |      * 上报定时任务结果.
16 |      */
17 |     protected function reportCronResult(string $id, bool $success, string $message): void
18 |     {
19 |         CronUtil::reportCronResult($id, $success, $message);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Event/CommonEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Event;
 6 | 
 7 | use Imi\Event\Contract\IEvent;
 8 | 
 9 | class CommonEvent implements IEvent
10 | {
11 |     /**
12 |      * 阻止事件继续传播.
13 |      */
14 |     protected bool $__stopPropagation = false;
15 | 
16 |     public function __construct(
17 |         /**
18 |          * 事件名称.
19 |          */
20 |         protected string $__eventName,
21 |         protected ?object $__target = null
22 |     ) {
23 |     }
24 | 
25 |     public function getEventName(): string
26 |     {
27 |         return $this->__eventName;
28 |     }
29 | 
30 |     public function getTarget(): ?object
31 |     {
32 |         return $this->__target;
33 |     }
34 | 
35 |     public function stopPropagation(bool $isStop = true): void
36 |     {
37 |         $this->__stopPropagation = $isStop;
38 |     }
39 | 
40 |     public function isPropagationStopped(): bool
41 |     {
42 |         return $this->__stopPropagation;
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Event/Contract/IEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Event\Contract;
 6 | 
 7 | interface IEvent
 8 | {
 9 |     /**
10 |      * 获取事件名称.
11 |      */
12 |     public function getEventName(): string;
13 | 
14 |     /**
15 |      * 事件所在目标对象
16 |      */
17 |     public function getTarget(): ?object;
18 | 
19 |     /**
20 |      * 阻止事件继续传播.
21 |      *
22 |      * @param bool $stoped 是否阻止事件继续传播
23 |      */
24 |     public function stopPropagation(bool $stoped = true): void;
25 | 
26 |     /**
27 |      * 是否阻止事件继续传播.
28 |      */
29 |     public function isPropagationStopped(): bool;
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Event/Contract/IEventDispatcher.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Event\Contract;
 6 | 
 7 | interface IEventDispatcher
 8 | {
 9 |     public function dispatch(IEvent $event): IEvent;
10 | 
11 |     public function getListenerProvider(): IListenerProvider;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Event/Contract/IListenerProvider.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Event\Contract;
 6 | 
 7 | use Imi\Event\RegisteredListener;
 8 | 
 9 | interface IListenerProvider
10 | {
11 |     /**
12 |      * @return iterable<RegisteredListener>
13 |      */
14 |     public function getListenersForEvent(IEvent $event): iterable;
15 | 
16 |     /**
17 |      * @return iterable<string, RegisteredListener[]>
18 |      */
19 |     public function getListeners(): iterable;
20 | 
21 |     public function addListener(string|array $eventNames, callable $listener, int $priority = 0, bool $once = false): void;
22 | 
23 |     public function removeListener(string|array $eventNames, ?callable $listener = null): void;
24 | 
25 |     public function clearListeners(): void;
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Event/EventDispatcher.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Event;
 6 | 
 7 | use Imi\Event\Contract\IEvent;
 8 | use Imi\Event\Contract\IEventDispatcher;
 9 | use Imi\Event\Contract\IListenerProvider;
10 | 
11 | class EventDispatcher implements IEventDispatcher
12 | {
13 |     public function __construct(protected IListenerProvider $listenerProvider = new ListenerProvider())
14 |     {
15 |     }
16 | 
17 |     public function getListenerProvider(): IListenerProvider
18 |     {
19 |         return $this->listenerProvider;
20 |     }
21 | 
22 |     public function dispatch(IEvent $event): IEvent
23 |     {
24 |         foreach ($this->listenerProvider->getListenersForEvent($event) as $listener)
25 |         {
26 |             /** @var IEvent $event */
27 |             ($listener->listener)($event);
28 |             if ($listener->once)
29 |             {
30 |                 $this->listenerProvider->removeListener($eventName ??= $event->getEventName(), $listener->listener);
31 |             }
32 |             if ($event->isPropagationStopped())
33 |             {
34 |                 break;
35 |             }
36 |         }
37 | 
38 |         return $event;
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Event/IEventListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Event;
 6 | 
 7 | use Imi\Event\Contract\IEvent;
 8 | 
 9 | /**
10 |  * 监听类接口.
11 |  */
12 | interface IEventListener
13 | {
14 |     /**
15 |      * 事件处理方法.
16 |      */
17 |     public function handle(IEvent $e): void;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Event/Listener/BuildRuntimeListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Event\Listener;
 6 | 
 7 | use Imi\Config;
 8 | use Imi\Event\ClassEventManager;
 9 | use Imi\Event\EventManager;
10 | use Imi\Event\IEventListener;
11 | 
12 | class BuildRuntimeListener implements IEventListener
13 | {
14 |     /**
15 |      * @param \Imi\Core\Runtime\Event\BuildRuntimeInfoEvent $e
16 |      */
17 |     public function handle(\Imi\Event\Contract\IEvent $e): void
18 |     {
19 |         if (!Config::get('@app.imi.runtime.event', true))
20 |         {
21 |             return;
22 |         }
23 |         $data = [];
24 |         $data['event'] = EventManager::getMap();
25 |         $data['classEvent'] = ClassEventManager::getMap();
26 |         $e->data['event'] = $data;
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Event/Listener/LoadRuntimeListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Event\Listener;
 6 | 
 7 | use Imi\Config;
 8 | use Imi\Event\ClassEventManager;
 9 | use Imi\Event\EventManager;
10 | use Imi\Event\IEventListener;
11 | 
12 | class LoadRuntimeListener implements IEventListener
13 | {
14 |     /**
15 |      * @param \Imi\Core\Runtime\Event\LoadRuntimeInfoEvent $e
16 |      */
17 |     public function handle(\Imi\Event\Contract\IEvent $e): void
18 |     {
19 |         $config = Config::get('@app.imi.runtime', []);
20 |         if (!($config['event'] ?? true))
21 |         {
22 |             return;
23 |         }
24 |         $data = $e->data['event'] ?? [];
25 |         EventManager::setMap($data['event'] ?? []);
26 |         ClassEventManager::setMap($data['classEvent'] ?? []);
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Event/RegisteredListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Event;
 6 | 
 7 | class RegisteredListener
 8 | {
 9 |     /**
10 |      * @var callable
11 |      */
12 |     public readonly mixed $listener;
13 | 
14 |     public readonly float $createTime;
15 | 
16 |     public function __construct(callable $listener,
17 |         /**
18 |          * 优先级
19 |          * 越大越先执行.
20 |          */
21 |         public readonly int $priority = 0,
22 |         /**
23 |          * 事件是否仅允许调用一次.
24 |          */
25 |         public readonly bool $once = false)
26 |     {
27 |         $this->listener = $listener;
28 |         $this->createTime = microtime(true);
29 |     }
30 | 
31 |     public function __invoke(object $event): void
32 |     {
33 |         ($this->listener)($event);
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Facade/Annotation/Facade.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Facade\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 门面定义.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_CLASS)]
13 | class Facade extends Base
14 | {
15 |     public function __construct(
16 |         /**
17 |          * 类名，支持 Bean 名.
18 |          */
19 |         public string $class = '',
20 |         /**
21 |          * 为 true 时，使用当前请求上下文的 Bean 对象
22 |          */
23 |         public bool $request = false,
24 |         /**
25 |          * 实例化参数.
26 |          */
27 |         public array $args = []
28 |     ) {
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Facade/Cli/template.tpl:
--------------------------------------------------------------------------------
 1 | <?php declare(strict_types=1);
 2 | echo '<?php'; ?>
 3 | 
 4 | declare(strict_types=1);
 5 | 
 6 | namespace <?php echo $namespace; ?>;
 7 | 
 8 | use Imi\Facade\BaseFacade;
 9 | 
10 | /**
11 | <?php foreach ($methods as $item)
12 | { ?>
13 | 
14 |  * <?php echo $item; ?>
15 | <?php } ?>
16 | 
17 |  */
18 | <?php echo $facadeAttribute; ?>
19 | 
20 | class <?php echo $shortClassName; ?> extends BaseFacade
21 | {
22 | 
23 | }
24 | 


--------------------------------------------------------------------------------
/src/HotUpdate/Event/HotUpdateBeginBuildEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\HotUpdate\Event;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | 
 9 | class HotUpdateBeginBuildEvent extends CommonEvent
10 | {
11 |     public bool $result = false;
12 | 
13 |     public function __construct(
14 |         public readonly array $changedFiles,
15 |         public readonly string $changedFilesFile,
16 |     ) {
17 |         parent::__construct(HotUpdateEvents::BEGIN_BUILD);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/HotUpdate/Event/HotUpdateEvents.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\HotUpdate\Event;
 6 | 
 7 | use Imi\Util\Traits\TStaticClass;
 8 | 
 9 | final class HotUpdateEvents
10 | {
11 |     use TStaticClass;
12 | 
13 |     public const BEGIN_BUILD = 'imi.hotupdate.begin_build';
14 | }
15 | 


--------------------------------------------------------------------------------
/src/HotUpdate/Monitor/BaseMonitor.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\HotUpdate\Monitor;
 6 | 
 7 | abstract class BaseMonitor implements IMonitor
 8 | {
 9 |     /**
10 |      * 构造方法.
11 |      *
12 |      * @param array $includePaths 包含的路径
13 |      * @param array $excludePaths 排除的路径
14 |      */
15 |     public function __construct(protected array $includePaths, protected array $excludePaths = [])
16 |     {
17 |         $this->init();
18 |     }
19 | 
20 |     /**
21 |      * 初始化.
22 |      */
23 |     abstract protected function init(): void;
24 | }
25 | 


--------------------------------------------------------------------------------
/src/HotUpdate/Monitor/IMonitor.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\HotUpdate\Monitor;
 6 | 
 7 | interface IMonitor
 8 | {
 9 |     /**
10 |      * 构造方法.
11 |      *
12 |      * @param array $includePaths 包含的路径
13 |      * @param array $excludePaths 排除的路径
14 |      */
15 |     public function __construct(array $includePaths, array $excludePaths = []);
16 | 
17 |     /**
18 |      * 检测文件是否有更改.
19 |      */
20 |     public function isChanged(): bool;
21 | 
22 |     /**
23 |      * 获取变更的文件们.
24 |      */
25 |     public function getChangedFiles(): array;
26 | }
27 | 


--------------------------------------------------------------------------------
/src/HttpValidate/Annotation/HttpValidation.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\HttpValidate\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 自动验证 Http 参数.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD)]
13 | class HttpValidation extends Base
14 | {
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Lock/Aop/LockAop.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Lock\Aop;
 6 | 
 7 | use Imi\Aop\Annotation\Around;
 8 | use Imi\Aop\Annotation\Aspect;
 9 | use Imi\Aop\Annotation\PointCut;
10 | use Imi\Aop\AroundJoinPoint;
11 | use Imi\Bean\Annotation\AnnotationManager;
12 | use Imi\Bean\BeanFactory;
13 | use Imi\Lock\Annotation\Lockable;
14 | 
15 | #[Aspect]
16 | class LockAop
17 | {
18 |     use TLockableParser;
19 | 
20 |     /**
21 |      * 处理方法加锁
22 |      */
23 |     #[PointCut(type: \Imi\Aop\PointCutType::ANNOTATION, allow: [\Imi\Lock\Annotation\Lockable::class])]
24 |     #[Around]
25 |     public function parseLock(AroundJoinPoint $joinPoint): mixed
26 |     {
27 |         $target = $joinPoint->getTarget();
28 |         $method = $joinPoint->getMethod();
29 |         $class = BeanFactory::getObjectClass($target);
30 |         /** @var Lockable|null $lockable */
31 |         $lockable = AnnotationManager::getMethodAnnotations($class, $method, Lockable::class, true, true);
32 | 
33 |         return $this->parseLockable($target, $method, $joinPoint->getArgs(), $lockable, static fn () => $joinPoint->proceed());
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Lock/Exception/LockFailException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Lock\Exception;
 6 | 
 7 | class LockFailException extends \Exception
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Lock/LockConfigOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Lock;
 6 | 
 7 | use Imi\Util\Traits\TDataToProperty;
 8 | 
 9 | /**
10 |  * 锁配置项.
11 |  */
12 | class LockConfigOption
13 | {
14 |     use TDataToProperty;
15 | 
16 |     /**
17 |      * 类名或 bean 名称.
18 |      */
19 |     public string $class = '';
20 | 
21 |     /**
22 |      * 配置项.
23 |      */
24 |     public array $options = [];
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Log/AbstractErrorEventHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Log;
 6 | 
 7 | abstract class AbstractErrorEventHandler implements IErrorEventHandler
 8 | {
 9 |     private bool $stopPropagation = false;
10 | 
11 |     /**
12 |      * 是否取消系统内部的错误域异常处理并停止后续处理器执行.
13 |      */
14 |     public function isPropagationStopped(): bool
15 |     {
16 |         return $this->stopPropagation;
17 |     }
18 | 
19 |     /**
20 |      * 取消系统内部的错误域异常处理并停止后续处理器执行.
21 |      */
22 |     public function stopPropagation(bool $stop = true): void
23 |     {
24 |         $this->stopPropagation = $stop;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Log/Handler/ConsoleHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Log\Handler;
 6 | 
 7 | use Imi\Cli\ImiCommand;
 8 | use Imi\Log\MonoLogger;
 9 | use Monolog\Handler\AbstractProcessingHandler;
10 | use Monolog\LogRecord;
11 | use Symfony\Component\Console\Output\OutputInterface;
12 | 
13 | /**
14 |  * {@inheritDoc}
15 |  */
16 | class ConsoleHandler extends AbstractProcessingHandler
17 | {
18 |     protected OutputInterface $output;
19 | 
20 |     /**
21 |      * {@inheritDoc}
22 |      */
23 |     public function __construct(?OutputInterface $output = null, $level = MonoLogger::DEBUG, bool $bubble = true)
24 |     {
25 |         $this->output = $output ?? ImiCommand::getOutput();
26 |         parent::__construct($level, $bubble);
27 |     }
28 | 
29 |     /**
30 |      * {@inheritdoc}
31 |      */
32 |     protected function write(LogRecord $record): void
33 |     {
34 |         $this->output->write((string) $record->formatted);
35 |     }
36 | 
37 |     public function getOutput(): OutputInterface
38 |     {
39 |         return $this->output;
40 |     }
41 | 
42 |     public function setOutput(OutputInterface $output): self
43 |     {
44 |         $this->output = $output;
45 | 
46 |         return $this;
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Log/IErrorEventHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Log;
 6 | 
 7 | interface IErrorEventHandler
 8 | {
 9 |     public function isPropagationStopped(): bool;
10 | 
11 |     /**
12 |      * 取消系统内部的错误域异常处理并停止后续处理器执行.
13 |      */
14 |     public function stopPropagation(bool $stop = true): void;
15 | 
16 |     public function handleError(int $errNo, string $errStr, string $errFile, int $errLine): void;
17 | 
18 |     public function handleException(\Throwable $throwable): void;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Log/LogLevel.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Log;
 6 | 
 7 | class LogLevel extends \Psr\Log\LogLevel
 8 | {
 9 |     public const ALL = [
10 |         self::ALERT,
11 |         self::CRITICAL,
12 |         self::DEBUG,
13 |         self::EMERGENCY,
14 |         self::ERROR,
15 |         self::INFO,
16 |         self::NOTICE,
17 |         self::WARNING,
18 |     ];
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Log/MonoLogger.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Log;
 6 | 
 7 | use Monolog\Logger;
 8 | 
 9 | /**
10 |  * @phpstan-ignore-next-line
11 |  */
12 | class MonoLogger extends Logger
13 | {
14 |     /**
15 |      * {@inheritDoc}
16 |      */
17 |     public function __construct(mixed ...$args)
18 |     {
19 |         parent::__construct(...$args);
20 | 
21 |         $this->useLoggingLoopDetection(false);
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Main/AppBaseMain.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Main;
 6 | 
 7 | use Imi\Config;
 8 | 
 9 | /**
10 |  * 项目主类基类.
11 |  */
12 | abstract class AppBaseMain extends BaseMain
13 | {
14 |     /**
15 |      * 获取配置.
16 |      */
17 |     public function getConfig(): array
18 |     {
19 |         if (null === $this->config)
20 |         {
21 |             return $this->config = Config::get('@app');
22 |         }
23 | 
24 |         return $this->config;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Main/IMain.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Main;
 6 | 
 7 | /**
 8 |  * 主类接口.
 9 |  */
10 | interface IMain
11 | {
12 |     public function __init(): void;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Pool/Annotation/PoolResource.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Pool\Annotation;
 6 | 
 7 | use Imi\Aop\Annotation\RequestInject;
 8 | use Imi\Bean\Annotation\Inherit;
 9 | use Imi\Pool\PoolManager;
10 | 
11 | /**
12 |  * 连接池对象注入.
13 |  */
14 | #[\Attribute(\Attribute::TARGET_PROPERTY)]
15 | #[Inherit]
16 | class PoolResource extends RequestInject
17 | {
18 |     /**
19 |      * 获取注入值的真实值
20 |      */
21 |     public function getRealValue(): mixed
22 |     {
23 |         return PoolManager::getRequestContextResource($this->name);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Pool/BasePoolResource.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Pool;
 6 | 
 7 | use Imi\Pool\Interfaces\IPool;
 8 | use Imi\Pool\Interfaces\IPoolResource;
 9 | use Imi\Util\Traits\THashCode;
10 | 
11 | abstract class BasePoolResource implements IPoolResource
12 | {
13 |     use THashCode;
14 | 
15 |     public function __construct(
16 |         /**
17 |          * 池子实例.
18 |          */
19 |         private readonly ?IPool $pool
20 |     ) {
21 |     }
22 | 
23 |     /**
24 |      * {@inheritDoc}
25 |      */
26 |     public function getPool(): IPool
27 |     {
28 |         return $this->pool;
29 |     }
30 | 
31 |     /**
32 |      * {@inheritDoc}
33 |      */
34 |     public function isOpened(): bool
35 |     {
36 |         return true;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Pool/Event/CheckPoolResourceEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Pool\Event;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | 
 9 | class CheckPoolResourceEvent extends CommonEvent
10 | {
11 |     public function __construct(
12 |         public bool $result
13 |     ) {
14 |         parent::__construct('IMI.CHECK_POOL_RESOURCE');
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Pool/Interfaces/IPoolResource.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Pool\Interfaces;
 6 | 
 7 | use Imi\Util\Interfaces\IHashCode;
 8 | 
 9 | /**
10 |  * 池子资源接口.
11 |  */
12 | interface IPoolResource extends IHashCode
13 | {
14 |     /**
15 |      * 打开
16 |      */
17 |     public function open(): bool;
18 | 
19 |     /**
20 |      * 关闭.
21 |      */
22 |     public function close(): void;
23 | 
24 |     /**
25 |      * 获取对象实例.
26 |      */
27 |     public function getInstance(): mixed;
28 | 
29 |     /**
30 |      * 获取池子实例.
31 |      */
32 |     public function getPool(): IPool;
33 | 
34 |     /**
35 |      * 重置资源，当资源被使用后重置一些默认的设置.
36 |      */
37 |     public function reset(): void;
38 | 
39 |     /**
40 |      * 检查资源是否可用.
41 |      */
42 |     public function checkState(): bool;
43 | 
44 |     /**
45 |      * 资源是否已打开
46 |      */
47 |     public function isOpened(): bool;
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Pool/Listener/ClearListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Pool\Listener;
 6 | 
 7 | use Imi\Bean\Annotation\Listener;
 8 | use Imi\Cli\Event\CommandEvents;
 9 | use Imi\Event\IEventListener;
10 | use Imi\Pool\PoolManager;
11 | 
12 | #[Listener(eventName: CommandEvents::AFTER_COMMAND)]
13 | class ClearListener implements IEventListener
14 | {
15 |     /**
16 |      * {@inheritDoc}
17 |      */
18 |     public function handle(\Imi\Event\Contract\IEvent $e): void
19 |     {
20 |         PoolManager::clearPools();
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Pool/Listener/RequestContextDestroy.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Pool\Listener;
 6 | 
 7 | use Imi\Event\IEventListener;
 8 | use Imi\Pool\PoolManager;
 9 | 
10 | class RequestContextDestroy implements IEventListener
11 | {
12 |     /**
13 |      * {@inheritDoc}
14 |      */
15 |     public function handle(\Imi\Event\Contract\IEvent $e): void
16 |     {
17 |         PoolManager::destroyCurrentContext();
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Pool/Listener/WorkerStart.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Pool\Listener;
 6 | 
 7 | use Imi\Bean\Annotation\Listener;
 8 | use Imi\Core\CoreEvents;
 9 | use Imi\Event\Event;
10 | use Imi\Event\IEventListener;
11 | use Imi\Util\ImiPriority;
12 | 
13 | #[Listener(eventName: CoreEvents::APP_RUN, priority: \Imi\Util\ImiPriority::IMI_MAX, one: true)]
14 | class WorkerStart implements IEventListener
15 | {
16 |     /**
17 |      * {@inheritDoc}
18 |      */
19 |     public function handle(\Imi\Event\Contract\IEvent $e): void
20 |     {
21 |         Event::on('IMI.REQUEST_CONTENT.DESTROY', [new \Imi\Pool\Listener\RequestContextDestroy(), 'handle'], ImiPriority::IMI_MIN - 30);
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Pool/ResourceConfigMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Pool;
 6 | 
 7 | class ResourceConfigMode
 8 | {
 9 |     use \Imi\Util\Traits\TStaticClass;
10 | 
11 |     /**
12 |      * 轮询.
13 |      */
14 |     public const ROUND_ROBIN = 1;
15 | 
16 |     /**
17 |      * 随机.
18 |      */
19 |     public const RANDOM = 2;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Pool/TUriResourceConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Pool;
 6 | 
 7 | use Imi\Util\Uri;
 8 | 
 9 | trait TUriResourceConfig
10 | {
11 |     protected function initUriResourceConfig(): void
12 |     {
13 |         foreach ($this->resourceConfig as &$config)
14 |         {
15 |             if (\is_array($config))
16 |             {
17 |                 continue;
18 |             }
19 |             $list = explode(';', (string) $config);
20 |             $config = [];
21 |             foreach ($list as $uri)
22 |             {
23 |                 $uriObj = new Uri($uri);
24 |                 parse_str($uriObj->getQuery(), $config);
25 |                 $config['host'] ??= $uriObj->getHost();
26 |                 $config['port'] ??= $uriObj->getPort();
27 |             }
28 |         }
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Process/Event/ProcessBeginEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Process\Event;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | 
 9 | class ProcessBeginEvent extends CommonEvent
10 | {
11 |     public function __construct(
12 |         public readonly string $name,
13 |         public readonly object $process,
14 |     ) {
15 |         parent::__construct(ProcessEvents::PROCESS_BEGIN);
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Process/Event/ProcessEndEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Process\Event;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | 
 9 | class ProcessEndEvent extends CommonEvent
10 | {
11 |     public function __construct(
12 |         public readonly string $name,
13 |         public readonly object $process,
14 |     ) {
15 |         parent::__construct(ProcessEvents::PROCESS_END);
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Process/Event/ProcessEvents.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Process\Event;
 6 | 
 7 | use Imi\Util\Traits\TStaticClass;
 8 | 
 9 | final class ProcessEvents
10 | {
11 |     use TStaticClass;
12 | 
13 |     /**
14 |      * 自定义进程开始.
15 |      */
16 |     public const PROCESS_BEGIN = 'imi.process.begin';
17 | 
18 |     /**
19 |      * 自定义进程结束.
20 |      */
21 |     public const PROCESS_END = 'imi.process.end';
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Redis/Annotation/RedisInject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Redis\Annotation;
 6 | 
 7 | use Imi\Aop\Annotation\RequestInject;
 8 | use Imi\Bean\Annotation\Inherit;
 9 | use Imi\Redis\RedisManager;
10 | 
11 | /**
12 |  * 连接池对象注入.
13 |  *
14 |  * {@inheritdoc}
15 |  */
16 | #[\Attribute(\Attribute::TARGET_PROPERTY)]
17 | #[Inherit]
18 | class RedisInject extends RequestInject
19 | {
20 |     /**
21 |      * 获取注入值的真实值
22 |      */
23 |     public function getRealValue(): mixed
24 |     {
25 |         return RedisManager::getInstance($this->name);
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Redis/Enum/RedisMode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Redis\Enum;
 6 | 
 7 | class RedisMode
 8 | {
 9 |     use \Imi\Util\Traits\TStaticClass;
10 | 
11 |     /**
12 |      * 单机.
13 |      */
14 |     public const STANDALONE = 'standalone';
15 | 
16 |     /**
17 |      * 哨兵模式.
18 |      */
19 |     public const SENTINEL = 'sentinel';
20 | 
21 |     /**
22 |      * 集群模式.
23 |      */
24 |     public const CLUSTER = 'cluster';
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Redis/SyncRedisPool.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Redis;
 6 | 
 7 | use Imi\Pool\BaseSyncPool;
 8 | use Imi\Pool\TUriResourceConfig;
 9 | use Imi\Redis\Traits\TRedisPool;
10 | 
11 | class SyncRedisPool extends BaseSyncPool
12 | {
13 |     use TRedisPool;
14 |     use TUriResourceConfig;
15 | 
16 |     /**
17 |      * 数据库操作类.
18 |      */
19 |     protected string $handlerClass = \Redis::class;
20 | 
21 |     /**
22 |      * {@inheritDoc}
23 |      */
24 |     public function __construct(string $name, \Imi\Pool\Interfaces\IPoolConfig $config = null, mixed $resourceConfig = null)
25 |     {
26 |         parent::__construct($name, $config, $resourceConfig);
27 |         $this->initUriResourceConfig();
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/RequestContextProxy/Annotation/RequestContextProxy.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\RequestContextProxy\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 请求上下文代理.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_CLASS)]
13 | class RequestContextProxy extends Base
14 | {
15 |     public function __construct(
16 |         /**
17 |          * 代理类名.
18 |          */
19 |         public ?string $class = null,
20 |         /**
21 |          * 请求上下文中的名称.
22 |          */
23 |         public string $name = ''
24 |     ) {
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/RequestContextProxy/Cli/template.tpl:
--------------------------------------------------------------------------------
 1 | <?php declare(strict_types=1);
 2 | echo '<?php'; ?>
 3 | 
 4 | namespace <?php echo $namespace; ?>;
 5 | 
 6 | use Imi\RequestContextProxy\BaseRequestContextProxy;
 7 | 
 8 | /**
 9 | <?php foreach ($methods as $item)
10 | { ?>
11 |  * <?php echo $item; ?>
12 | 
13 | <?php } ?>
14 |  */
15 | <?php echo $classAttributesCode; ?>
16 | 
17 | class <?php echo $shortClassName; ?> extends BaseRequestContextProxy<?php if ($interface)
18 | { ?> implements \<?php echo $interface; ?><?php }?>
19 | 
20 | {
21 | <?php echo $methodCodes; ?>
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Server/Annotation/ServerInject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Annotation;
 6 | 
 7 | use Imi\Aop\Annotation\BaseInjectValue;
 8 | use Imi\App;
 9 | use Imi\Bean\Annotation\Inherit;
10 | use Imi\RequestContext;
11 | 
12 | /**
13 |  * 服务器容器对象注入
14 |  * 使用：RequestContext::getServerBean().
15 |  */
16 | #[\Attribute(\Attribute::TARGET_PROPERTY)]
17 | #[Inherit]
18 | class ServerInject extends BaseInjectValue
19 | {
20 |     public function __construct(
21 |         /**
22 |          * Bean名称或类名.
23 |          */
24 |         public string $name = '',
25 |         /**
26 |          * Bean实例化参数.
27 |          */
28 |         public array $args = []
29 |     ) {
30 |     }
31 | 
32 |     /**
33 |      * 获取注入值的真实值
34 |      */
35 |     public function getRealValue(): mixed
36 |     {
37 |         if ($server = RequestContext::getServer())
38 |         {
39 |             return $server->getBean($this->name, ...$this->args);
40 |         }
41 | 
42 |         return App::getBean($this->name, ...$this->args);
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Server/ConnectionContext/Event/ConnectionContextEvents.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\ConnectionContext\Event;
 6 | 
 7 | use Imi\Util\Traits\TStaticClass;
 8 | 
 9 | class ConnectionContextEvents
10 | {
11 |     use TStaticClass;
12 | 
13 |     public const RESTORE = 'imi.connect_context.restore';
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Server/ConnectionContext/Event/Listener/IConnectionContextRestoreListener.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\ConnectionContext\Event\Listener;
 6 | 
 7 | use Imi\Server\ConnectionContext\Event\Param\ConnectionContextRestoreParam;
 8 | 
 9 | /**
10 |  * 连接上下文数据恢复事件监听.
11 |  */
12 | interface IConnectionContextRestoreListener
13 | {
14 |     public function handle(ConnectionContextRestoreParam $e): void;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Server/ConnectionContext/Event/Param/ConnectionContextRestoreParam.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\ConnectionContext\Event\Param;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | use Imi\Server\ConnectionContext\Event\ConnectionContextEvents;
 9 | 
10 | /**
11 |  * 连接上下文数据恢复事件参数.
12 |  */
13 | class ConnectionContextRestoreParam extends CommonEvent
14 | {
15 |     public function __construct(
16 |         /**
17 |          * 数据原始连接号.
18 |          */
19 |         public readonly int $fromClientId = 0,
20 |         /**
21 |          * 数据目标连接号（当前连接号）.
22 |          */
23 |         public readonly int $toClientId = 0,
24 |         /**
25 |          * 服务器名.
26 |          */
27 |         public readonly ?string $serverName = null)
28 |     {
29 |         parent::__construct(ConnectionContextEvents::RESTORE);
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Server/ConnectionContext/Traits/TConnectionContextRelease.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\ConnectionContext\Traits;
 6 | 
 7 | use Imi\ConnectionContext;
 8 | use Imi\RequestContext;
 9 | 
10 | /**
11 |  * 连接上下文关闭释放.
12 |  */
13 | trait TConnectionContextRelease
14 | {
15 |     public function release(int|string $clientId): void
16 |     {
17 |         $groups = ConnectionContext::get('__groups', [], $clientId);
18 | 
19 |         $server = RequestContext::getServer();
20 |         // 当前连接离开所有组
21 |         // @phpstan-ignore-next-line
22 |         $server->getBean('ClientIdMap')->leaveAll($clientId);
23 | 
24 |         ConnectionContext::set('__groups', $groups, $clientId);
25 | 
26 |         // 标记绑定连接释放
27 |         if ($flag = ConnectionContext::getFlagByClientId($clientId))
28 |         {
29 |             /** @var \Imi\Server\ConnectionContext\StoreHandler $store */
30 |             $store = $server->getBean('ConnectionContextStore');
31 |             ConnectionContext::unbind($flag, $clientId, $store->getTtl());
32 |         }
33 | 
34 |         ConnectionContext::destroy($clientId);
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Server/DataParser/IParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\DataParser;
 6 | 
 7 | use Imi\Util\Format\IFormat;
 8 | 
 9 | interface IParser extends IFormat
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Server/DataParser/JsonArrayParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\DataParser;
 6 | 
 7 | class JsonArrayParser implements IParser
 8 | {
 9 |     /**
10 |      * 由以下常量组成的二进制掩码：
11 |      * JSON_HEX_QUOT
12 |      * JSON_HEX_TAG
13 |      * JSON_HEX_AMP
14 |      * JSON_HEX_APOS
15 |      * JSON_NUMERIC_CHECK
16 |      * JSON_PRETTY_PRINT
17 |      * JSON_UNESCAPED_SLASHES
18 |      * JSON_FORCE_OBJECT
19 |      * JSON_PRESERVE_ZERO_FRACTION
20 |      * JSON_UNESCAPED_UNICODE
21 |      * JSON_PARTIAL_OUTPUT_ON_ERROR。
22 |      */
23 |     protected int $options = \JSON_THROW_ON_ERROR | \JSON_UNESCAPED_SLASHES | \JSON_UNESCAPED_UNICODE;
24 | 
25 |     /**
26 |      * 设置最大深度。 必须大于0。
27 |      */
28 |     protected int $depth = 512;
29 | 
30 |     /**
31 |      * {@inheritDoc}
32 |      */
33 |     public function encode(mixed $data): string
34 |     {
35 |         return json_encode($data, $this->options, $this->depth);
36 |     }
37 | 
38 |     /**
39 |      * {@inheritDoc}
40 |      */
41 |     public function decode(string $data): mixed
42 |     {
43 |         return json_decode($data, true, $this->depth, $this->options);
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Server/DataParser/JsonObjectParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\DataParser;
 6 | 
 7 | class JsonObjectParser implements IParser
 8 | {
 9 |     /**
10 |      * 由以下常量组成的二进制掩码：
11 |      * JSON_HEX_QUOT
12 |      * JSON_HEX_TAG
13 |      * JSON_HEX_AMP
14 |      * JSON_HEX_APOS
15 |      * JSON_NUMERIC_CHECK
16 |      * JSON_PRETTY_PRINT
17 |      * JSON_UNESCAPED_SLASHES
18 |      * JSON_FORCE_OBJECT
19 |      * JSON_PRESERVE_ZERO_FRACTION
20 |      * JSON_UNESCAPED_UNICODE
21 |      * JSON_PARTIAL_OUTPUT_ON_ERROR。
22 |      */
23 |     protected int $options = \JSON_THROW_ON_ERROR | \JSON_UNESCAPED_SLASHES | \JSON_UNESCAPED_UNICODE;
24 | 
25 |     /**
26 |      * 设置最大深度。 必须大于0。
27 |      */
28 |     protected int $depth = 512;
29 | 
30 |     /**
31 |      * {@inheritDoc}
32 |      */
33 |     public function encode(mixed $data): string
34 |     {
35 |         return json_encode($data, $this->options, $this->depth);
36 |     }
37 | 
38 |     /**
39 |      * {@inheritDoc}
40 |      */
41 |     public function decode(string $data): mixed
42 |     {
43 |         return json_decode($data, false, $this->depth, $this->options);
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Server/Event/AfterCreateServerEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Event;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | use Imi\Server\Contract\IServer;
 9 | 
10 | class AfterCreateServerEvent extends CommonEvent
11 | {
12 |     public function __construct(
13 |         public readonly string $name,
14 |         public readonly array $config,
15 |         public readonly array $args,
16 |         public readonly IServer $server
17 |     ) {
18 |         parent::__construct(ServerEvents::AFTER_CREATE_SERVER);
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Server/Event/BeforeCreateServerEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Event;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | 
 9 | class BeforeCreateServerEvent extends CommonEvent
10 | {
11 |     public function __construct(
12 |         public readonly string $name,
13 |         public readonly array $config,
14 |         public readonly array $args
15 |     ) {
16 |         parent::__construct(ServerEvents::BEFORE_CREATE_SERVER);
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Server/Event/PipeMessageEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Event;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | 
 9 | class PipeMessageEvent extends CommonEvent
10 | {
11 |     public function __construct(string $__eventName, public readonly mixed $data)
12 |     {
13 |         parent::__construct($__eventName);
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Server/Event/ServerEvents.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Event;
 6 | 
 7 | use Imi\Util\Traits\TStaticClass;
 8 | 
 9 | final class ServerEvents
10 | {
11 |     use TStaticClass;
12 | 
13 |     /**
14 |      * 创建服务器对象前置操作.
15 |      */
16 |     public const BEFORE_CREATE_SERVER = 'imi.server.create.before';
17 | 
18 |     /**
19 |      * 创建服务器对象后置操作.
20 |      */
21 |     public const AFTER_CREATE_SERVER = 'imi.server.create.after';
22 | 
23 |     /**
24 |      * 创建服务器前置操作.
25 |      */
26 |     public const BEFORE_CREATE_SERVERS = 'imi.servers.create.before';
27 | 
28 |     /**
29 |      * 创建服务器后置操作.
30 |      */
31 |     public const AFTER_CREATE_SERVERS = 'imi.servers.create.after';
32 | 
33 |     /**
34 |      * 服务器启动前.
35 |      */
36 |     public const BEFORE_SERVER_START = 'imi.server.before_start';
37 | 
38 |     /**
39 |      * 工作进程启动事件.
40 |      */
41 |     public const WORKER_START = 'imi.server.worker_start';
42 | 
43 |     /**
44 |      * 在工作进程中执行的应用初始化.
45 |      */
46 |     public const WORKER_APP_START = 'imi.server.worker.app.start';
47 | 
48 |     /**
49 |      * 工作进程停止事件.
50 |      */
51 |     public const WORKER_STOP = 'imi.server.worker_stop';
52 | }
53 | 


--------------------------------------------------------------------------------
/src/Server/Event/WorkerStartEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Event;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | use Imi\Server\Contract\IServer;
 9 | 
10 | class WorkerStartEvent extends CommonEvent
11 | {
12 |     public function __construct(
13 |         string $__eventName,
14 |         public readonly IServer $server,
15 |         public readonly int $workerId
16 |     ) {
17 |         parent::__construct($__eventName, $server);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Server/Event/WorkerStopEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Event;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | use Imi\Server\Contract\IServer;
 9 | 
10 | class WorkerStopEvent extends CommonEvent
11 | {
12 |     public function __construct(
13 |         public readonly IServer $server,
14 |         public readonly int $workerId
15 |     ) {
16 |         parent::__construct(ServerEvents::WORKER_STOP, $server);
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Server/Group/Contract/IServerGroup.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Group\Contract;
 6 | 
 7 | use Imi\Server\Group\Group;
 8 | 
 9 | interface IServerGroup
10 | {
11 |     /**
12 |      * 组是否存在.
13 |      */
14 |     public function hasGroup(string $groupName): bool;
15 | 
16 |     /**
17 |      * 创建组，返回组对象
18 |      */
19 |     public function createGroup(string $groupName, int $maxClients = -1): Group;
20 | 
21 |     /**
22 |      * 获取组对象，不存在返回null.
23 |      */
24 |     public function getGroup(string $groupName): ?Group;
25 | 
26 |     /**
27 |      * 加入组，组不存在则自动创建.
28 |      */
29 |     public function joinGroup(string $groupName, int|string $clientId): void;
30 | 
31 |     /**
32 |      * 离开组，组不存在则自动创建.
33 |      */
34 |     public function leaveGroup(string $groupName, int|string $clientId): void;
35 | 
36 |     /**
37 |      * 调用组方法.
38 |      */
39 |     public function groupCall(string $groupName, string $methodName, mixed ...$args): mixed;
40 | 
41 |     /**
42 |      * 获取所有组列表.
43 |      *
44 |      * @return \Imi\Server\Group\Group[]
45 |      */
46 |     public function getGroups(): array;
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Server/Group/Event/JoinGroupEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Group\Event;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | use Imi\Server\Contract\IServer;
 9 | 
10 | class JoinGroupEvent extends CommonEvent
11 | {
12 |     public function __construct(
13 |         public readonly IServer $server,
14 |         public readonly string $groupName,
15 |         public readonly string|int $clientId
16 |     ) {
17 |         parent::__construct(ServerGroupEvents::JOIN_GROUP, $server);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Server/Group/Event/LeaveGroupEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Group\Event;
 6 | 
 7 | use Imi\Event\CommonEvent;
 8 | use Imi\Server\Contract\IServer;
 9 | 
10 | class LeaveGroupEvent extends CommonEvent
11 | {
12 |     public function __construct(
13 |         public readonly IServer $server,
14 |         public readonly string $groupName,
15 |         public readonly string|int $clientId
16 |     ) {
17 |         parent::__construct(ServerGroupEvents::LEAVE_GROUP, $server);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Server/Group/Event/ServerGroupEvents.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Group\Event;
 6 | 
 7 | use Imi\Util\Traits\TStaticClass;
 8 | 
 9 | final class ServerGroupEvents
10 | {
11 |     use TStaticClass;
12 | 
13 |     /**
14 |      * 加入服务器逻辑分组事件.
15 |      */
16 |     public const JOIN_GROUP = 'imi.server.group.join';
17 | 
18 |     /**
19 |      * 离开服务器逻辑分组事件.
20 |      */
21 |     public const LEAVE_GROUP = 'imi.server.group.leave';
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Server/Group/Exception/MethodNotFoundException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Group\Exception;
 6 | 
 7 | class MethodNotFoundException extends \Exception
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Server/Group/Handler/IGroupHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Group\Handler;
 6 | 
 7 | interface IGroupHandler
 8 | {
 9 |     /**
10 |      * 启动时执行.
11 |      */
12 |     public function startup(): void;
13 | 
14 |     /**
15 |      * 组是否存在.
16 |      */
17 |     public function hasGroup(string $groupName): bool;
18 | 
19 |     /**
20 |      * 创建组，返回组对象
21 |      */
22 |     public function createGroup(string $groupName, int $maxClients = -1): void;
23 | 
24 |     /**
25 |      * 加入组，组不存在则自动创建.
26 |      */
27 |     public function joinGroup(string $groupName, int|string $clientId): bool;
28 | 
29 |     /**
30 |      * 离开组，组不存在则自动创建.
31 |      */
32 |     public function leaveGroup(string $groupName, int|string $clientId): bool;
33 | 
34 |     /**
35 |      * 连接是否存在于组里.
36 |      */
37 |     public function isInGroup(string $groupName, int|string $clientId): bool;
38 | 
39 |     /**
40 |      * 获取所有连接ID.
41 |      *
42 |      * @return int[]|string[]
43 |      */
44 |     public function getClientIds(string $groupName): array;
45 | 
46 |     /**
47 |      * 获取在组中的连接总数.
48 |      */
49 |     public function count(string $groupName): int;
50 | 
51 |     /**
52 |      * 清空分组.
53 |      */
54 |     public function clear(): void;
55 | }
56 | 


--------------------------------------------------------------------------------
/src/Server/Http/Annotation/RequestParam.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 请求参数.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_PARAMETER | \Attribute::IS_REPEATABLE)]
13 | class RequestParam extends Base
14 | {
15 |     public function __construct(
16 |         /**
17 |          * 导出数据名称；支持：$get.id、$post.content、$body.name.
18 |          */
19 |         public string $name = '',
20 |         /**
21 |          * 导出数据到的方法参数名.
22 |          */
23 |         public string $param = '',
24 |         /**
25 |          * 是否必选参数.
26 |          */
27 |         public bool $required = true,
28 |         /**
29 |          * 参数不存在时的默认值
30 |          *
31 |          * @var mixed
32 |          */
33 |         public $default = null
34 |     ) {
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Server/Http/Cli/template.tpl:
--------------------------------------------------------------------------------
 1 | <?php declare(strict_types=1);
 2 | echo '<?php'; ?>
 3 | 
 4 | declare(strict_types=1);
 5 | 
 6 | namespace <?php echo $namespace; ?>;
 7 | 
 8 | use Imi\Server\Http\Controller\HttpController;
 9 | use Imi\Server\View\Annotation\View;
10 | use Imi\Server\Http\Route\Annotation\Action;
11 | use Imi\Server\Http\Route\Annotation\Controller;
12 | 
13 | <?php echo $classAttributesCode; ?>
14 | 
15 | class <?php echo $name; ?> extends HttpController
16 | {
17 |     /**
18 |      * index
19 |      */
20 |     #[Action]
21 |     public function index(): array
22 |     {
23 |         return ['success'=>true];
24 |     }
25 | }


--------------------------------------------------------------------------------
/src/Server/Http/Error/ErrorHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Error;
 6 | 
 7 | use Imi\Bean\Annotation\Bean;
 8 | use Imi\RequestContext;
 9 | 
10 | #[Bean(name: 'HttpErrorHandler')]
11 | class ErrorHandler implements IErrorHandler
12 | {
13 |     protected string $handler = JsonErrorHandler::class;
14 | 
15 |     /**
16 |      * {@inheritDoc}
17 |      */
18 |     public function handle(\Throwable $throwable): bool
19 |     {
20 |         return RequestContext::getServerBean($this->handler)->handle($throwable);
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Server/Http/Error/ExecuteTimeoutHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Error;
 6 | 
 7 | use Imi\Bean\Annotation\Bean;
 8 | use Imi\Server\Http\Message\Contract\IHttpRequest;
 9 | use Imi\Server\Http\Message\Contract\IHttpResponse;
10 | use Imi\Util\Http\Consts\StatusCode;
11 | use Imi\Util\Stream\MemoryStream;
12 | 
13 | /**
14 |  * 执行超时处理器.
15 |  */
16 | #[Bean(name: 'ExecuteTimeoutHandler')]
17 | class ExecuteTimeoutHandler implements IExecuteTimeoutHandler
18 | {
19 |     /**
20 |      * {@inheritDoc}
21 |      */
22 |     public function handle(IHttpRequest $request, IHttpResponse $response): mixed
23 |     {
24 |         $response->setStatus(StatusCode::INTERNAL_SERVER_ERROR)->setBody(new MemoryStream('<h1>Request execute timeout</h1>'))->send();
25 | 
26 |         return null;
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Server/Http/Error/HttpNotFoundHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Error;
 6 | 
 7 | use Imi\App;
 8 | use Imi\Bean\Annotation\Bean;
 9 | use Imi\Server\Http\Message\Contract\IHttpRequest;
10 | use Imi\Server\Http\Message\Contract\IHttpResponse;
11 | use Imi\Util\Http\Consts\StatusCode;
12 | use Psr\Http\Server\RequestHandlerInterface;
13 | 
14 | /**
15 |  * http 未匹配路由时的处理器.
16 |  */
17 | #[Bean(name: 'HttpNotFoundHandler')]
18 | class HttpNotFoundHandler implements IHttpNotFoundHandler
19 | {
20 |     /**
21 |      * 处理器类名，如果为null则使用默认处理.
22 |      */
23 |     protected string $handler = '';
24 | 
25 |     /**
26 |      * {@inheritDoc}
27 |      */
28 |     public function handle(RequestHandlerInterface $requesthandler, IHttpRequest $request, IHttpResponse $response): IHttpResponse
29 |     {
30 |         if ('' === $this->handler)
31 |         {
32 |             return $response->setStatus(StatusCode::NOT_FOUND);
33 |         }
34 |         else
35 |         {
36 |             return App::getBean($this->handler)->handle($requesthandler, $request, $response);
37 |         }
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Server/Http/Error/IErrorHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Error;
 6 | 
 7 | /**
 8 |  * Http 服务错误捕获器.
 9 |  */
10 | interface IErrorHandler
11 | {
12 |     /**
13 |      * 捕获错误
14 |      * 返回值为 true 则取消继续抛出异常.
15 |      */
16 |     public function handle(\Throwable $throwable): bool;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Server/Http/Error/IExecuteTimeoutHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Error;
 6 | 
 7 | use Imi\Server\Http\Message\Contract\IHttpRequest;
 8 | use Imi\Server\Http\Message\Contract\IHttpResponse;
 9 | 
10 | /**
11 |  * 执行超时接口.
12 |  */
13 | interface IExecuteTimeoutHandler
14 | {
15 |     public function handle(IHttpRequest $request, IHttpResponse $response): mixed;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Server/Http/Error/IHttpNotFoundHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Error;
 6 | 
 7 | use Imi\Server\Http\Message\Contract\IHttpRequest;
 8 | use Imi\Server\Http\Message\Contract\IHttpResponse;
 9 | use Psr\Http\Server\RequestHandlerInterface;
10 | 
11 | /**
12 |  * 处理未找到 Http 路由情况的接口.
13 |  */
14 | interface IHttpNotFoundHandler
15 | {
16 |     public function handle(RequestHandlerInterface $requesthandler, IHttpRequest $request, IHttpResponse $response): IHttpResponse;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Server/Http/Message/Contract/IHttpRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Message\Contract;
 6 | 
 7 | use Imi\Util\Http\Contract\IServerRequest;
 8 | use Imi\Util\Socket\IPEndPoint;
 9 | 
10 | /**
11 |  * Http 请求接口.
12 |  */
13 | interface IHttpRequest extends IServerRequest
14 | {
15 |     /**
16 |      * 获取客户端地址
17 |      */
18 |     public function getClientAddress(): IPEndPoint;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Server/Http/Message/Emitter/Contract/BaseEmitter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Message\Emitter\Contract;
 6 | 
 7 | abstract class BaseEmitter implements IResponseBodyEmitter
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Server/Http/Message/Emitter/Contract/IResponseBodyEmitter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Message\Emitter\Contract;
 6 | 
 7 | use Imi\Server\Http\Message\Contract\IHttpResponse;
 8 | use Imi\Server\Http\Message\Emitter\Handler\IEmitHandler;
 9 | 
10 | interface IResponseBodyEmitter
11 | {
12 |     public function init(IHttpResponse &$response, IEmitHandler $handler): void;
13 | 
14 |     public function getHandler(): IEmitHandler;
15 | 
16 |     public function send(): void;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Server/Http/Message/Emitter/Handler/IEmitHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Message\Emitter\Handler;
 6 | 
 7 | interface IEmitHandler
 8 | {
 9 |     public function send(string $data): bool;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Server/Http/Message/Emitter/SseEmitter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Message\Emitter;
 6 | 
 7 | use Imi\Server\Http\Message\Contract\IHttpResponse;
 8 | use Imi\Server\Http\Message\Emitter\Contract\BaseEmitter;
 9 | use Imi\Server\Http\Message\Emitter\Handler\IEmitHandler;
10 | use Imi\Util\Http\Consts\MediaType;
11 | use Imi\Util\Http\Consts\ResponseHeader;
12 | 
13 | abstract class SseEmitter extends BaseEmitter
14 | {
15 |     private IEmitHandler $handler;
16 | 
17 |     public function init(IHttpResponse &$response, IEmitHandler $handler): void
18 |     {
19 |         $this->handler = $handler;
20 |         $response->setHeader(ResponseHeader::CONTENT_TYPE, MediaType::TEXT_EVENT_STREAM)
21 |                  ->setHeader(ResponseHeader::CACHE_CONTROL, 'no-cache')
22 |                  ->setHeader(ResponseHeader::CONNECTION, 'Keep-Alive')
23 |                  ->setHeader('X-Accel-Buffering', 'no') // 禁用 Nginx 缓冲区
24 |         ;
25 |     }
26 | 
27 |     public function getHandler(): IEmitHandler
28 |     {
29 |         return $this->handler;
30 |     }
31 | 
32 |     public function send(): void
33 |     {
34 |         $this->task();
35 |     }
36 | 
37 |     abstract protected function task(): void;
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Server/Http/Message/Emitter/SseMessageEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Message\Emitter;
 6 | 
 7 | class SseMessageEvent implements \Stringable
 8 | {
 9 |     public function __construct(public ?string $data = null, public ?string $event = null, public ?string $id = null, public ?int $retry = null, public ?string $comment = null)
10 |     {
11 |     }
12 | 
13 |     public function __toString(): string
14 |     {
15 |         $buffer = '';
16 |         if (null !== $this->comment)
17 |         {
18 |             $buffer = ": {$this->comment}\n";
19 |         }
20 |         if (null !== $this->event)
21 |         {
22 |             $buffer .= "event: {$this->event}\n";
23 |         }
24 |         if (null !== $this->id)
25 |         {
26 |             $buffer .= "id: {$this->id}\n";
27 |         }
28 |         if (null !== $this->retry)
29 |         {
30 |             $buffer .= "retry: {$this->retry}\n";
31 |         }
32 |         if (null !== $this->data)
33 |         {
34 |             $buffer .= 'data: ' . str_replace("\n", "\ndata: ", $this->data) . "\n";
35 |         }
36 |         if ('' === $buffer)
37 |         {
38 |             throw new \InvalidArgumentException('SSE message must not be empty');
39 |         }
40 | 
41 |         return $buffer . "\n";
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Server/Http/Message/Request.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Message;
 6 | 
 7 | use Imi\Server\Http\Message\Contract\IHttpRequest;
 8 | use Imi\Util\Http\ServerRequest;
 9 | 
10 | abstract class Request extends ServerRequest implements IHttpRequest
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Server/Http/Parser/ControllerParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Parser;
 6 | 
 7 | use Imi\Bean\Parser\BaseParser;
 8 | use Imi\Server\Http\Route\Annotation\Controller;
 9 | use Imi\Util\Traits\TServerAnnotationParser;
10 | 
11 | /**
12 |  * 控制器注解处理器.
13 |  */
14 | class ControllerParser extends BaseParser
15 | {
16 |     use TServerAnnotationParser;
17 | 
18 |     public function __construct()
19 |     {
20 |         $this->controllerAnnotationClass = Controller::class;
21 |     }
22 | 
23 |     /**
24 |      * {@inheritDoc}
25 |      */
26 |     public function parse(\Imi\Bean\Annotation\Base $annotation, string $className, string $target, string $targetName): void
27 |     {
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Server/Http/Route/Annotation/Action.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * 动作注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_METHOD)]
14 | #[Parser(className: \Imi\Server\Http\Parser\ControllerParser::class)]
15 | class Action extends Base
16 | {
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Server/Http/Route/Annotation/Controller.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * 控制器注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Server\Http\Parser\ControllerParser::class)]
15 | class Controller extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 路由前缀
20 |          */
21 |         public ?string $prefix = null,
22 |         /**
23 |          * 指定当前控制器允许哪些服务器使用；支持字符串或数组，默认为 null 则不限制.
24 |          *
25 |          * @var string|string[]|null
26 |          */
27 |         public $server = null
28 |     ) {
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Server/Http/Route/Annotation/Middleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * 中间件注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Server\Http\Parser\ControllerParser::class)]
15 | class Middleware extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 中间件类或数组.
20 |          *
21 |          * @var string|string[]|null
22 |          */
23 |         public $middlewares = null
24 |     ) {
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Server/Http/Route/RouteItem.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Route;
 6 | 
 7 | use Imi\Server\Http\Route\Annotation\Route;
 8 | use Imi\Server\View\Annotation\BaseViewOption;
 9 | use Imi\Server\View\Annotation\View;
10 | use Imi\Server\WebSocket\Route\Annotation\WSConfig;
11 | 
12 | class RouteItem
13 | {
14 |     /**
15 |      * 回调.
16 |      *
17 |      * @var callable
18 |      */
19 |     public $callable;
20 | 
21 |     /**
22 |      * 中间件列表.
23 |      */
24 |     public array $middlewares = [];
25 | 
26 |     /**
27 |      * WebSocket 配置.
28 |      */
29 |     public ?WSConfig $wsConfig = null;
30 | 
31 |     public function __construct(
32 |         /**
33 |          * 注解.
34 |          */
35 |         public ?Route $annotation, callable $callable,
36 |         /**
37 |          * 视图注解.
38 |          */
39 |         public ?View $view,
40 |         /**
41 |          * 视图配置注解.
42 |          */
43 |         public ?BaseViewOption $viewOption = null,
44 |         /**
45 |          * 其它配置项.
46 |          */
47 |         public array $options = [])
48 |     {
49 |         $this->callable = $callable;
50 |     }
51 | }
52 | 


--------------------------------------------------------------------------------
/src/Server/Http/Route/RouteResult.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\Route;
 6 | 
 7 | class RouteResult
 8 | {
 9 |     /**
10 |      * 回调.
11 |      *
12 |      * @var callable
13 |      */
14 |     public $callable;
15 | 
16 |     public function __construct(
17 |         /**
18 |          * 路由ID.
19 |          */
20 |         public int $id,
21 |         /**
22 |          * 路由配置项.
23 |          */
24 |         public ?RouteItem $routeItem,
25 |         /**
26 |          * 参数.
27 |          */
28 |         public array $params)
29 |     {
30 |         $this->callable = $routeItem->callable;
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Server/Http/SuperGlobals/Listener/SuperGlobals.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\SuperGlobals\Listener;
 6 | 
 7 | use Imi\Bean\Annotation\Bean;
 8 | use Imi\Server\Http\SuperGlobals\Cookie;
 9 | use Imi\Server\Http\SuperGlobals\Files;
10 | use Imi\Server\Http\SuperGlobals\Get;
11 | use Imi\Server\Http\SuperGlobals\Post;
12 | use Imi\Server\Http\SuperGlobals\Request;
13 | use Imi\Server\Http\SuperGlobals\Server;
14 | use Imi\Server\Http\SuperGlobals\Session;
15 | 
16 | #[Bean(name: 'SuperGlobals')]
17 | class SuperGlobals
18 | {
19 |     /**
20 |      * 是否启用 Hook 超全局变量.
21 |      */
22 |     protected bool $enable = false;
23 | 
24 |     public function bind(): void
25 |     {
26 |         if ($this->enable)
27 |         {
28 |             $_GET = new Get();
29 |             $_POST = new Post();
30 |             $_REQUEST = new Request();
31 |             $_SESSION = new Session();
32 |             $_COOKIE = new Cookie();
33 |             $_FILES = new Files();
34 |             $_SERVER = new Server($_SERVER);
35 |         }
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Server/Http/SuperGlobals/Session.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Http\SuperGlobals;
 6 | 
 7 | use Imi\Server\Session\Session as ImiSession;
 8 | 
 9 | class Session implements \ArrayAccess, \JsonSerializable
10 | {
11 |     public function offsetSet(mixed $key, mixed $value): void
12 |     {
13 |         ImiSession::set($key, $value);
14 |     }
15 | 
16 |     public function offsetExists(mixed $key): bool
17 |     {
18 |         return null !== ImiSession::get($key);
19 |     }
20 | 
21 |     public function offsetUnset(mixed $key): void
22 |     {
23 |         ImiSession::delete($key);
24 |     }
25 | 
26 |     public function offsetGet(mixed $key): mixed
27 |     {
28 |         return ImiSession::get($key);
29 |     }
30 | 
31 |     public function __debugInfo(): array
32 |     {
33 |         return $this->jsonSerialize();
34 |     }
35 | 
36 |     /**
37 |      * {@inheritDoc}
38 |      */
39 |     public function jsonSerialize(): mixed
40 |     {
41 |         return ImiSession::get();
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Server/Protocol.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server;
 6 | 
 7 | class Protocol
 8 | {
 9 |     use \Imi\Util\Traits\TStaticClass;
10 | 
11 |     public const HTTP = 'http';
12 | 
13 |     public const WEBSOCKET = 'websocket';
14 | 
15 |     public const TCP = 'tcp';
16 | 
17 |     public const UDP = 'udp';
18 | 
19 |     public const LONG_CONNECTION_PROTOCOLS = [
20 |         self::WEBSOCKET,
21 |         self::TCP,
22 |     ];
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Server/Route/TMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Route;
 6 | 
 7 | use Imi\Config;
 8 | 
 9 | trait TMiddleware
10 | {
11 |     /**
12 |      * 获取真实的中间件列表.
13 |      *
14 |      * @param string|string[] $middlewares
15 |      */
16 |     protected function getMiddlewares($middlewares, string $serverName): array
17 |     {
18 |         if (\is_array($middlewares))
19 |         {
20 |             return $middlewares;
21 |         }
22 |         elseif (isset($middlewares[0]) && '@' === $middlewares[0])
23 |         {
24 |             return Config::get('@server.' . $serverName . '.middleware.groups.' . substr($middlewares, 1), []);
25 |         }
26 |         else
27 |         {
28 |             return [$middlewares];
29 |         }
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Server/Session/Handler/ISessionHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Session\Handler;
 6 | 
 7 | /**
 8 |  * Session处理器接口.
 9 |  */
10 | interface ISessionHandler
11 | {
12 |     /**
13 |      * 销毁session数据.
14 |      */
15 |     public function destroy(string $sessionId): void;
16 | 
17 |     /**
18 |      * 垃圾回收.
19 |      *
20 |      * @param int $maxLifeTime 最大存活时间，单位：秒
21 |      */
22 |     public function gc(int $maxLifeTime): void;
23 | 
24 |     /**
25 |      * 读取session.
26 |      */
27 |     public function read(string $sessionId): mixed;
28 | 
29 |     /**
30 |      * 写入session.
31 |      */
32 |     public function write(string $sessionId, string $sessionData, int $maxLifeTime): void;
33 | 
34 |     /**
35 |      * 生成SessionId.
36 |      */
37 |     public function createSessionId(): string;
38 | 
39 |     /**
40 |      * 编码为存储格式.
41 |      */
42 |     public function encode(array $data): string;
43 | 
44 |     /**
45 |      * 解码为php数组.
46 |      */
47 |     public function decode(string $data): array;
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Server/Session/SessionConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Session;
 6 | 
 7 | use Imi\Bean\Annotation\Bean;
 8 | use Imi\Server\Annotation\ServerInject;
 9 | 
10 | #[Bean(name: 'SessionConfig')]
11 | class SessionConfig
12 | {
13 |     #[ServerInject(name: 'SessionCookie')]
14 |     public SessionCookie $cookie;
15 | 
16 |     public function __construct(
17 |         /**
18 |          * session名称.
19 |          */
20 |         public string $name = 'imisid', ?SessionCookie $cookie = null,
21 |         /**
22 |          * 每次请求完成后触发垃圾回收的概率，默认为1%
23 |          * 可取值0~1.0，概率为0%~100%.
24 |          */
25 |         public float $gcProbability = 0.01,
26 |         /**
27 |          * 最大存活时间，默认30天，单位秒.
28 |          */
29 |         public int $maxLifeTime = 86400 * 30,
30 |         /**
31 |          * Session 前缀
32 |          */
33 |         public ?string $prefix = null)
34 |     {
35 |         if (null !== $cookie)
36 |         {
37 |             $this->cookie = $cookie;
38 |         }
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Server/Session/SessionCookie.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\Session;
 6 | 
 7 | use Imi\Bean\Annotation\Bean;
 8 | 
 9 | #[Bean(name: 'SessionCookie')]
10 | class SessionCookie
11 | {
12 |     /**
13 |      * 是否启用 Cookie.
14 |      */
15 |     public bool $enable = true;
16 | 
17 |     public function __construct(
18 |         /**
19 |          * Cookie 的 生命周期，以秒为单位。
20 |          */
21 |         public int $lifetime = 0,
22 |         /**
23 |          * 此 cookie 的有效路径。 on the domain where 设置为“/”表示对于本域上所有的路径此 cookie 都可用。
24 |          */
25 |         public string $path = '/',
26 |         /**
27 |          * Cookie 的作用域。 例如：“www.php.net”。 如果要让 cookie 在所有的子域中都可用，此参数必须以点（.）开头，例如：“.php.net”。
28 |          */
29 |         public string $domain = '',
30 |         /**
31 |          * 设置为 TRUE 表示 cookie 仅在使用安全链接时可用。
32 |          */
33 |         public bool $secure = false,
34 |         /**
35 |          * 设置为 TRUE 表示 PHP 发送 cookie 的时候会使用 httponly 标记。
36 |          */
37 |         public bool $httponly = false
38 |     ) {
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Contract/ITcpServer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Contract;
 6 | 
 7 | use Imi\Server\Contract\IServer;
 8 | use Imi\Server\Group\Contract\IServerGroup;
 9 | 
10 | interface ITcpServer extends IServer, IServerGroup
11 | {
12 |     /**
13 |      * 向客户端发送消息.
14 |      */
15 |     public function send(int|string $clientId, string $data): bool;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Controller/TcpController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Controller;
 6 | 
 7 | use Imi\RequestContext;
 8 | use Imi\Server\TcpServer\Contract\ITcpServer;
 9 | use Imi\Server\TcpServer\Message\IReceiveData;
10 | 
11 | /**
12 |  * TCP 控制器.
13 |  */
14 | abstract class TcpController
15 | {
16 |     /**
17 |      * 服务器对象
18 |      */
19 |     public ?ITcpServer $server = null;
20 | 
21 |     /**
22 |      * 数据.
23 |      */
24 |     public IReceiveData $data;
25 | 
26 |     public function __construct()
27 |     {
28 |         // @phpstan-ignore-next-line
29 |         $server = $this->server = RequestContext::getServer();
30 |         // @phpstan-ignore-next-line
31 |         $this->data = $server->getBean('TcpReceiveDataProxy');
32 |     }
33 | 
34 |     /**
35 |      * 编码消息，把数据编码为发送给客户端的格式.
36 |      */
37 |     protected function encodeMessage(mixed $data): string
38 |     {
39 |         return RequestContext::getServerBean(\Imi\Server\DataParser\DataParser::class)->encode($data);
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Error/ErrorHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Error;
 6 | 
 7 | use Imi\Bean\Annotation\Bean;
 8 | use Imi\RequestContext;
 9 | 
10 | #[Bean(name: 'TcpErrorHandler')]
11 | class ErrorHandler implements IErrorHandler
12 | {
13 |     protected ?string $handler = null;
14 | 
15 |     /**
16 |      * {@inheritDoc}
17 |      */
18 |     public function handle(\Throwable $throwable): bool
19 |     {
20 |         if ($this->handler)
21 |         {
22 |             return RequestContext::getServerBean($this->handler)->handle($throwable);
23 |         }
24 |         else
25 |         {
26 |             return false;
27 |         }
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Error/IErrorHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Error;
 6 | 
 7 | /**
 8 |  * TcpServer 服务错误捕获器.
 9 |  */
10 | interface IErrorHandler
11 | {
12 |     /**
13 |      * 捕获错误
14 |      * 返回值为 true 则取消继续抛出异常.
15 |      */
16 |     public function handle(\Throwable $throwable): bool;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Error/ITcpRouteNotFoundHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Error;
 6 | 
 7 | use Imi\Server\TcpServer\IReceiveHandler;
 8 | use Imi\Server\TcpServer\Message\IReceiveData;
 9 | 
10 | /**
11 |  * 处理未找到 TCP 路由情况的接口.
12 |  */
13 | interface ITcpRouteNotFoundHandler
14 | {
15 |     /**
16 |      * 处理方法.
17 |      */
18 |     public function handle(IReceiveData $data, IReceiveHandler $handler): mixed;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Error/TcpRouteNotFoundHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Error;
 6 | 
 7 | use Imi\App;
 8 | use Imi\Bean\Annotation\Bean;
 9 | use Imi\Server\TcpServer\IReceiveHandler;
10 | use Imi\Server\TcpServer\Message\IReceiveData;
11 | 
12 | /**
13 |  * TCP 未匹配路由时的处理器.
14 |  */
15 | #[Bean(name: 'TcpRouteNotFoundHandler')]
16 | class TcpRouteNotFoundHandler implements ITcpRouteNotFoundHandler
17 | {
18 |     /**
19 |      * 处理器类名，如果为null则使用默认处理.
20 |      */
21 |     protected ?string $handler = null;
22 | 
23 |     /**
24 |      * {@inheritDoc}
25 |      */
26 |     public function handle(IReceiveData $data, IReceiveHandler $handler): mixed
27 |     {
28 |         if (null !== $this->handler)
29 |         {
30 |             return App::getBean($this->handler)->handle($data, $handler);
31 |         }
32 | 
33 |         return null;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/IReceiveHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer;
 6 | 
 7 | use Imi\Server\TcpServer\Message\IReceiveData;
 8 | 
 9 | interface IReceiveHandler
10 | {
11 |     /**
12 |      * 返回值为响应内容，为null则无任何响应.
13 |      */
14 |     public function handle(IReceiveData $data): mixed;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Message/IReceiveData.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Message;
 6 | 
 7 | use Imi\Util\Socket\IPEndPoint;
 8 | 
 9 | interface IReceiveData
10 | {
11 |     /**
12 |      * 获取客户端的socket id.
13 |      */
14 |     public function getClientId(): int|string;
15 | 
16 |     /**
17 |      * 数据内容，可以是文本内容也可以是二进制数据，可以通过opcode的值来判断.
18 |      */
19 |     public function getData(): string;
20 | 
21 |     /**
22 |      * 获取格式化后的数据，一般是数组或对象
23 |      */
24 |     public function getFormatData(): mixed;
25 | 
26 |     /**
27 |      * 获取客户端地址
28 |      */
29 |     public function getClientAddress(): IPEndPoint;
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Middleware/IMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Middleware;
 6 | 
 7 | use Imi\Server\TcpServer\IReceiveHandler;
 8 | use Imi\Server\TcpServer\Message\IReceiveData;
 9 | 
10 | interface IMiddleware
11 | {
12 |     public function process(IReceiveData $data, IReceiveHandler $handler): mixed;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Parser/TcpControllerParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Parser;
 6 | 
 7 | use Imi\Bean\Parser\BaseParser;
 8 | use Imi\Server\TcpServer\Route\Annotation\TcpController;
 9 | use Imi\Util\Traits\TServerAnnotationParser;
10 | 
11 | /**
12 |  * 控制器注解处理器.
13 |  */
14 | class TcpControllerParser extends BaseParser
15 | {
16 |     use TServerAnnotationParser;
17 | 
18 |     public function __construct()
19 |     {
20 |         $this->controllerAnnotationClass = TcpController::class;
21 |     }
22 | 
23 |     /**
24 |      * {@inheritDoc}
25 |      */
26 |     public function parse(\Imi\Bean\Annotation\Base $annotation, string $className, string $target, string $targetName): void
27 |     {
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Route/Annotation/TcpAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * Tcp 动作注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_METHOD)]
14 | #[Parser(className: \Imi\Server\TcpServer\Parser\TcpControllerParser::class)]
15 | class TcpAction extends Base
16 | {
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Route/Annotation/TcpController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * Tcp 控制器注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Server\TcpServer\Parser\TcpControllerParser::class)]
15 | class TcpController extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 指定当前控制器允许哪些服务器使用；支持字符串或数组，默认为 null 则不限制.
20 |          *
21 |          * @var string|string[]|null
22 |          */
23 |         public $server = null
24 |     ) {
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Route/Annotation/TcpMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * Tcp 中间件注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Server\TcpServer\Parser\TcpControllerParser::class)]
15 | class TcpMiddleware extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * @var string|string[]|null
20 |          */
21 |         public $middlewares = null
22 |     ) {
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Route/Annotation/TcpRoute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * Tcp 路由注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Server\TcpServer\Parser\TcpControllerParser::class)]
15 | class TcpRoute extends Base implements \Stringable
16 | {
17 |     public function __toString(): string
18 |     {
19 |         return http_build_query($this->toArray());
20 |     }
21 | 
22 |     public function __construct(
23 |         /**
24 |          * 条件.
25 |          */
26 |         public array $condition = []
27 |     ) {
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Route/IRoute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Route;
 6 | 
 7 | interface IRoute
 8 | {
 9 |     /**
10 |      * 路由解析处理.
11 |      */
12 |     public function parse(mixed $data): ?RouteResult;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Route/RouteItem.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Route;
 6 | 
 7 | use Imi\Server\TcpServer\Route\Annotation\TcpRoute;
 8 | 
 9 | class RouteItem
10 | {
11 |     /**
12 |      * 回调.
13 |      *
14 |      * @var callable
15 |      */
16 |     public $callable;
17 | 
18 |     /**
19 |      * 中间件列表.
20 |      */
21 |     public array $middlewares = [];
22 | 
23 |     public function __construct(
24 |         /**
25 |          * 注解.
26 |          */
27 |         public ?TcpRoute $annotation, callable $callable,
28 |         /**
29 |          * 其它配置项.
30 |          */
31 |         public array $options = [])
32 |     {
33 |         $this->callable = $callable;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Server/TcpServer/Route/RouteResult.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\TcpServer\Route;
 6 | 
 7 | class RouteResult
 8 | {
 9 |     /**
10 |      * 回调.
11 |      *
12 |      * @var callable
13 |      */
14 |     public $callable;
15 | 
16 |     public function __construct(
17 |         /**
18 |          * 路由配置项.
19 |          */
20 |         public RouteItem $routeItem,
21 |         /**
22 |          * 参数.
23 |          */
24 |         public array $params = [])
25 |     {
26 |         $this->callable = $routeItem->callable;
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Contract/IUdpServer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Contract;
 6 | 
 7 | use Imi\Server\Contract\IServer;
 8 | use Imi\Server\Group\Contract\IServerGroup;
 9 | 
10 | interface IUdpServer extends IServer, IServerGroup
11 | {
12 |     /**
13 |      * 向客户端发送消息.
14 |      */
15 |     public function sendTo(string $ip, int $port, string $data): bool;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Controller/UdpController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Controller;
 6 | 
 7 | use Imi\RequestContext;
 8 | use Imi\Server\UdpServer\Contract\IUdpServer;
 9 | use Imi\Server\UdpServer\Message\IPacketData;
10 | 
11 | /**
12 |  * UDP 控制器.
13 |  */
14 | abstract class UdpController
15 | {
16 |     /**
17 |      * 服务器对象
18 |      */
19 |     public ?IUdpServer $server = null;
20 | 
21 |     /**
22 |      * 包数据.
23 |      */
24 |     public IPacketData $data;
25 | 
26 |     public function __construct()
27 |     {
28 |         // @phpstan-ignore-next-line
29 |         $server = $this->server = RequestContext::getServer();
30 |         // @phpstan-ignore-next-line
31 |         $this->data = $server->getBean('UdpPacketDataProxy');
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Error/ErrorHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Error;
 6 | 
 7 | use Imi\Bean\Annotation\Bean;
 8 | use Imi\RequestContext;
 9 | 
10 | #[Bean(name: 'UdpErrorHandler')]
11 | class ErrorHandler implements IErrorHandler
12 | {
13 |     protected ?string $handler = null;
14 | 
15 |     /**
16 |      * {@inheritDoc}
17 |      */
18 |     public function handle(\Throwable $throwable): bool
19 |     {
20 |         if ($this->handler)
21 |         {
22 |             return RequestContext::getServerBean($this->handler)->handle($throwable);
23 |         }
24 |         else
25 |         {
26 |             return false;
27 |         }
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Error/IErrorHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Error;
 6 | 
 7 | /**
 8 |  * UdpServer 服务错误捕获器.
 9 |  */
10 | interface IErrorHandler
11 | {
12 |     /**
13 |      * 捕获错误
14 |      * 返回值为 true 则取消继续抛出异常.
15 |      */
16 |     public function handle(\Throwable $throwable): bool;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Error/IUdpRouteNotFoundHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Error;
 6 | 
 7 | use Imi\Server\UdpServer\IPacketHandler;
 8 | use Imi\Server\UdpServer\Message\IPacketData;
 9 | 
10 | /**
11 |  * 处理未找到 UDP 路由情况的接口.
12 |  */
13 | interface IUdpRouteNotFoundHandler
14 | {
15 |     /**
16 |      * 处理方法.
17 |      */
18 |     public function handle(IPacketData $data, IPacketHandler $handler): mixed;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Error/UdpRouteNotFoundHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Error;
 6 | 
 7 | use Imi\App;
 8 | use Imi\Bean\Annotation\Bean;
 9 | use Imi\Server\UdpServer\IPacketHandler;
10 | use Imi\Server\UdpServer\Message\IPacketData;
11 | 
12 | /**
13 |  * UDP 未匹配路由时的处理器.
14 |  */
15 | #[Bean(name: 'UdpRouteNotFoundHandler')]
16 | class UdpRouteNotFoundHandler implements IUdpRouteNotFoundHandler
17 | {
18 |     /**
19 |      * 处理器类名，如果为null则使用默认处理.
20 |      */
21 |     protected ?string $handler = null;
22 | 
23 |     /**
24 |      * {@inheritDoc}
25 |      */
26 |     public function handle(IPacketData $data, IPacketHandler $handler): mixed
27 |     {
28 |         if (null !== $this->handler)
29 |         {
30 |             return App::getBean($this->handler)->handle($data, $handler);
31 |         }
32 | 
33 |         return null;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/IPacketHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer;
 6 | 
 7 | use Imi\Server\UdpServer\Message\IPacketData;
 8 | 
 9 | interface IPacketHandler
10 | {
11 |     /**
12 |      * 返回值为响应内容，为null则无任何响应.
13 |      */
14 |     public function handle(IPacketData $data): mixed;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Message/IPacketData.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Message;
 6 | 
 7 | use Imi\Util\Socket\IPEndPoint;
 8 | 
 9 | interface IPacketData
10 | {
11 |     /**
12 |      * 数据内容.
13 |      */
14 |     public function getData(): string;
15 | 
16 |     /**
17 |      * 获取格式化后的数据，一般是数组或对象
18 |      */
19 |     public function getFormatData(): mixed;
20 | 
21 |     /**
22 |      * 获取客户端地址
23 |      */
24 |     public function getClientAddress(): IPEndPoint;
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Message/PacketData.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Message;
 6 | 
 7 | use Imi\RequestContext;
 8 | use Imi\Server\DataParser\DataParser;
 9 | use Imi\Util\Socket\IPEndPoint;
10 | 
11 | class PacketData implements IPacketData
12 | {
13 |     /**
14 |      * 客户端地址
15 |      */
16 |     protected ?IPEndPoint $clientAddress = null;
17 | 
18 |     /**
19 |      * 接收到的数据.
20 |      */
21 |     protected mixed $formatData;
22 | 
23 |     public function __construct(string $remoteIp, int $remotePort,
24 |         /**
25 |          * 数据内容.
26 |          */
27 |         protected string $data)
28 |     {
29 |         $this->clientAddress = new IPEndPoint($remoteIp, $remotePort);
30 |         $this->formatData = RequestContext::getServerBean(DataParser::class)->decode($data);
31 |     }
32 | 
33 |     /**
34 |      * {@inheritDoc}
35 |      */
36 |     public function getData(): string
37 |     {
38 |         return $this->data;
39 |     }
40 | 
41 |     /**
42 |      * {@inheritDoc}
43 |      */
44 |     public function getFormatData(): mixed
45 |     {
46 |         return $this->formatData;
47 |     }
48 | 
49 |     /**
50 |      * {@inheritDoc}
51 |      */
52 |     public function getClientAddress(): IPEndPoint
53 |     {
54 |         return $this->clientAddress;
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Middleware/IMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Middleware;
 6 | 
 7 | use Imi\Server\UdpServer\IPacketHandler;
 8 | use Imi\Server\UdpServer\Message\IPacketData;
 9 | 
10 | interface IMiddleware
11 | {
12 |     public function process(IPacketData $data, IPacketHandler $handler): mixed;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Parser/UdpControllerParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Parser;
 6 | 
 7 | use Imi\Bean\Parser\BaseParser;
 8 | use Imi\Server\UdpServer\Route\Annotation\UdpController;
 9 | use Imi\Util\Traits\TServerAnnotationParser;
10 | 
11 | /**
12 |  * 控制器注解处理器.
13 |  */
14 | class UdpControllerParser extends BaseParser
15 | {
16 |     use TServerAnnotationParser;
17 | 
18 |     public function __construct()
19 |     {
20 |         $this->controllerAnnotationClass = UdpController::class;
21 |     }
22 | 
23 |     /**
24 |      * {@inheritDoc}
25 |      */
26 |     public function parse(\Imi\Bean\Annotation\Base $annotation, string $className, string $target, string $targetName): void
27 |     {
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Route/Annotation/UdpAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * Udp 动作注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_METHOD)]
14 | #[Parser(className: \Imi\Server\UdpServer\Parser\UdpControllerParser::class)]
15 | class UdpAction extends Base
16 | {
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Route/Annotation/UdpController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * Udp 控制器注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Server\UdpServer\Parser\UdpControllerParser::class)]
15 | class UdpController extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 指定当前控制器允许哪些服务器使用；支持字符串或数组，默认为 null 则不限制.
20 |          *
21 |          * @var string|string[]|null
22 |          */
23 |         public $server = null
24 |     ) {
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Route/Annotation/UdpMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * Udp 中间件注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Server\UdpServer\Parser\UdpControllerParser::class)]
15 | class UdpMiddleware extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 中间件类或数组.
20 |          *
21 |          * @var string|string[]|null
22 |          */
23 |         public $middlewares = null
24 |     ) {
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Route/Annotation/UdpRoute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * Udp 路由注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Server\UdpServer\Parser\UdpControllerParser::class)]
15 | class UdpRoute extends Base implements \Stringable
16 | {
17 |     public function __toString(): string
18 |     {
19 |         return http_build_query($this->toArray());
20 |     }
21 | 
22 |     public function __construct(
23 |         /**
24 |          * 条件.
25 |          */
26 |         public array $condition = []
27 |     ) {
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Route/IRoute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Route;
 6 | 
 7 | interface IRoute
 8 | {
 9 |     /**
10 |      * 路由解析处理.
11 |      */
12 |     public function parse(mixed $data): ?RouteResult;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Route/RouteItem.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Route;
 6 | 
 7 | use Imi\Server\UdpServer\Route\Annotation\UdpRoute;
 8 | 
 9 | class RouteItem
10 | {
11 |     /**
12 |      * 回调.
13 |      *
14 |      * @var callable
15 |      */
16 |     public $callable;
17 | 
18 |     /**
19 |      * 中间件列表.
20 |      */
21 |     public array $middlewares = [];
22 | 
23 |     public function __construct(
24 |         /**
25 |          * 注解.
26 |          */
27 |         public ?UdpRoute $annotation, callable $callable,
28 |         /**
29 |          * 其它配置项.
30 |          */
31 |         public array $options = [])
32 |     {
33 |         $this->callable = $callable;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Server/UdpServer/Route/RouteResult.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\UdpServer\Route;
 6 | 
 7 | class RouteResult
 8 | {
 9 |     /**
10 |      * 回调.
11 |      *
12 |      * @var callable
13 |      */
14 |     public $callable;
15 | 
16 |     public function __construct(
17 |         /**
18 |          * 路由配置项.
19 |          */
20 |         public RouteItem $routeItem,
21 |         /**
22 |          * 参数.
23 |          */
24 |         public array $params = [])
25 |     {
26 |         $this->callable = $routeItem->callable;
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Server/View/Annotation/BaseViewOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\View\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 视图配置注解基类.
11 |  */
12 | abstract class BaseViewOption extends Base
13 | {
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Server/View/Annotation/HtmlView.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\View\Annotation;
 6 | 
 7 | /**
 8 |  * HTML 视图配置注解.
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
11 | class HtmlView extends BaseViewOption
12 | {
13 |     public function __construct(
14 |         /**
15 |          * 模版基础路径；abc-配置中设定的路径/abc/；/abc/-绝对路径.
16 |          */
17 |         public ?string $baseDir = null,
18 |         /**
19 |          * 模版路径.
20 |          */
21 |         public ?string $template = null
22 |     ) {
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Server/View/Annotation/JsonView.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\View\Annotation;
 6 | 
 7 | /**
 8 |  * JSON 视图配置注解.
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
11 | class JsonView extends BaseViewOption
12 | {
13 |     public function __construct(
14 |         /**
15 |          * 由以下常量组成的二进制掩码：JSON_HEX_QUOT、JSON_HEX_TAG、JSON_HEX_AMP、JSON_HEX_APOS、JSON_NUMERIC_CHECK、JSON_PRETTY_PRINT、JSON_UNESCAPED_SLASHES、JSON_FORCE_OBJECT、JSON_PRESERVE_ZERO_FRACTION、JSON_UNESCAPED_UNICODE、JSON_PARTIAL_OUTPUT_ON_ERROR.
16 |          */
17 |         public int $options = \JSON_THROW_ON_ERROR | \JSON_UNESCAPED_SLASHES | \JSON_UNESCAPED_UNICODE,
18 |         /**
19 |          * 设置最大深度。 必须大于0。
20 |          */
21 |         public int $depth = 512
22 |     ) {
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Server/View/Annotation/View.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\View\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * 视图注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
14 | #[Parser(className: \Imi\Server\View\Parser\ViewParser::class)]
15 | class View extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 渲染类型.
20 |          */
21 |         public string $renderType = 'json',
22 |         /**
23 |          * 附加数据.
24 |          *
25 |          * @var mixed
26 |          */
27 |         public $data = [],
28 |         /**
29 |          * 视图配置注解.
30 |          */
31 |         public ?BaseViewOption $option = null
32 |     ) {
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Server/View/Annotation/XmlView.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\View\Annotation;
 6 | 
 7 | /**
 8 |  * XML 视图配置注解.
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
11 | class XmlView extends BaseViewOption
12 | {
13 |     public function __construct()
14 |     {
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Server/View/Engine/IEngine.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\View\Engine;
 6 | 
 7 | use Imi\Server\Http\Message\Contract\IHttpResponse;
 8 | 
 9 | interface IEngine
10 | {
11 |     public function render(IHttpResponse $response, string $fileName, array $data = []): IHttpResponse;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Server/View/Engine/Php.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\View\Engine;
 6 | 
 7 | use Imi\Server\Http\Message\Contract\IHttpResponse;
 8 | 
 9 | /**
10 |  * PHP原生模版引擎.
11 |  */
12 | class Php implements IEngine
13 | {
14 |     /**
15 |      * {@inheritDoc}
16 |      */
17 |     public function render(IHttpResponse $response, string $fileName, array $data = []): IHttpResponse
18 |     {
19 |         if (!is_file($fileName))
20 |         {
21 |             return $response;
22 |         }
23 |         $closure = static function (string $__renderFileName, $__renderData): void {
24 |             if (\is_array($__renderData))
25 |             {
26 |                 extract($__renderData);
27 |             }
28 |             include $__renderFileName;
29 |         };
30 |         ob_start();
31 |         $closure($fileName, $data);
32 | 
33 |         $response->getBody()->write(ob_get_clean());
34 | 
35 |         return $response;
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Server/View/Handler/IHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\View\Handler;
 6 | 
 7 | use Imi\Server\Http\Message\Contract\IHttpResponse;
 8 | use Imi\Server\View\Annotation\BaseViewOption;
 9 | use Imi\Server\View\Annotation\View;
10 | 
11 | interface IHandler
12 | {
13 |     public function handle(View $viewAnnotation, ?BaseViewOption $viewOption, mixed $data, IHttpResponse $response): IHttpResponse;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Server/View/Handler/Xml.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\View\Handler;
 6 | 
 7 | use Imi\Bean\Annotation\Bean;
 8 | use Imi\Server\Http\Message\Contract\IHttpResponse;
 9 | use Imi\Server\View\Annotation\BaseViewOption;
10 | use Imi\Server\View\Annotation\View;
11 | use Imi\Util\Http\Consts\MediaType;
12 | use Imi\Util\Http\Consts\ResponseHeader;
13 | 
14 | /**
15 |  * Xml视图处理器.
16 |  */
17 | #[Bean(name: 'XmlView')]
18 | class Xml implements IHandler
19 | {
20 |     /**
21 |      * {@inheritDoc}
22 |      */
23 |     public function handle(View $viewAnnotation, ?BaseViewOption $viewOption, mixed $data, IHttpResponse $response): IHttpResponse
24 |     {
25 |         $response->setHeader(ResponseHeader::CONTENT_TYPE, MediaType::APPLICATION_XML);
26 |         if ($data instanceof \DOMDocument)
27 |         {
28 |             $response->getBody()->write($data->saveXML());
29 |         }
30 |         elseif ($data instanceof \SimpleXMLElement)
31 |         {
32 |             $response->getBody()->write($data->asXML());
33 |         }
34 |         else
35 |         {
36 |             throw new \RuntimeException('Unsupport xml object type: ' . \gettype($data));
37 |         }
38 | 
39 |         return $response;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Contract/IWebSocketServer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Contract;
 6 | 
 7 | use Imi\Server\Contract\IServer;
 8 | use Imi\Server\Group\Contract\IServerGroup;
 9 | use Imi\Server\WebSocket\Enum\NonControlFrameType;
10 | 
11 | interface IWebSocketServer extends IServer, IServerGroup
12 | {
13 |     /**
14 |      * 向客户端推送消息.
15 |      */
16 |     public function push(int|string $clientId, string $data, int $opcode = 1): bool;
17 | 
18 |     /**
19 |      * 非控制帧类型.
20 |      */
21 |     public function getNonControlFrameType(): NonControlFrameType;
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Controller/WebSocketController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Controller;
 6 | 
 7 | use Imi\RequestContext;
 8 | use Imi\Server\WebSocket\Contract\IWebSocketServer;
 9 | use Imi\Server\WebSocket\Message\IFrame;
10 | 
11 | /**
12 |  * WebSocket 控制器.
13 |  */
14 | abstract class WebSocketController
15 | {
16 |     /**
17 |      * 服务器对象
18 |      */
19 |     public ?IWebSocketServer $server = null;
20 | 
21 |     /**
22 |      * 桢.
23 |      */
24 |     public IFrame $frame;
25 | 
26 |     public function __construct()
27 |     {
28 |         // @phpstan-ignore-next-line
29 |         $server = $this->server = RequestContext::getServer();
30 |         // @phpstan-ignore-next-line
31 |         $this->frame = $server->getBean('WebSocketFrameProxy');
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Enum/NonControlFrameType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Enum;
 6 | 
 7 | /**
 8 |  * Websocket 非控制帧类型.
 9 |  */
10 | enum NonControlFrameType: int
11 | {
12 |     /**
13 |      * 文本帧.
14 |      */
15 |     case Text = 1;
16 | 
17 |     /**
18 |      * 二进制帧.
19 |      */
20 |     case Binary = 2;
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Error/ErrorHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Error;
 6 | 
 7 | use Imi\Bean\Annotation\Bean;
 8 | use Imi\RequestContext;
 9 | 
10 | #[Bean(name: 'WebSocketErrorHandler')]
11 | class ErrorHandler implements IErrorHandler
12 | {
13 |     protected ?string $handler = null;
14 | 
15 |     /**
16 |      * {@inheritDoc}
17 |      */
18 |     public function handle(\Throwable $throwable): bool
19 |     {
20 |         if ($this->handler)
21 |         {
22 |             return RequestContext::getServerBean($this->handler)->handle($throwable);
23 |         }
24 |         else
25 |         {
26 |             return false;
27 |         }
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Error/IErrorHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Error;
 6 | 
 7 | /**
 8 |  * WebSocket 服务错误捕获器.
 9 |  */
10 | interface IErrorHandler
11 | {
12 |     /**
13 |      * 捕获错误
14 |      * 返回值为 true 则取消继续抛出异常.
15 |      */
16 |     public function handle(\Throwable $throwable): bool;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Error/IWSRouteNotFoundHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Error;
 6 | 
 7 | use Imi\Server\WebSocket\IMessageHandler;
 8 | use Imi\Server\WebSocket\Message\IFrame;
 9 | 
10 | /**
11 |  * 处理未找到 WebSocket 路由情况的接口.
12 |  */
13 | interface IWSRouteNotFoundHandler
14 | {
15 |     /**
16 |      * 处理方法.
17 |      */
18 |     public function handle(IFrame $frame, IMessageHandler $handler): mixed;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Error/WSRouteNotFoundHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Error;
 6 | 
 7 | use Imi\App;
 8 | use Imi\Bean\Annotation\Bean;
 9 | use Imi\Server\WebSocket\IMessageHandler;
10 | use Imi\Server\WebSocket\Message\IFrame;
11 | 
12 | /**
13 |  * WebSocket 未匹配路由时的处理器.
14 |  */
15 | #[Bean(name: 'WSRouteNotFoundHandler')]
16 | class WSRouteNotFoundHandler implements IWSRouteNotFoundHandler
17 | {
18 |     /**
19 |      * 处理器类名，如果为null则使用默认处理.
20 |      */
21 |     protected ?string $handler = null;
22 | 
23 |     /**
24 |      * {@inheritDoc}
25 |      */
26 |     public function handle(IFrame $frame, IMessageHandler $handler): mixed
27 |     {
28 |         if (null !== $this->handler)
29 |         {
30 |             return App::getBean($this->handler)->handle($frame, $handler);
31 |         }
32 | 
33 |         return null;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/IMessageHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket;
 6 | 
 7 | use Imi\Server\WebSocket\Message\IFrame;
 8 | 
 9 | interface IMessageHandler
10 | {
11 |     /**
12 |      * 返回值为响应内容，为null则无任何响应.
13 |      */
14 |     public function handle(IFrame $frame): mixed;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Message/IFrame.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Message;
 6 | 
 7 | use Imi\Util\Socket\IPEndPoint;
 8 | 
 9 | interface IFrame
10 | {
11 |     /**
12 |      * 获取客户端的socket id.
13 |      */
14 |     public function getClientId(): int|string;
15 | 
16 |     /**
17 |      * 数据内容，可以是文本内容也可以是二进制数据，可以通过opcode的值来判断.
18 |      */
19 |     public function getData(): string;
20 | 
21 |     /**
22 |      * 获取格式化后的数据，一般是数组或对象
23 |      */
24 |     public function getFormatData(): mixed;
25 | 
26 |     /**
27 |      * WebSocket的OpCode类型，可以参考WebSocket协议标准文档
28 |      * WEBSOCKET_OPCODE_TEXT = 0x1 ，文本数据
29 |      * WEBSOCKET_OPCODE_BINARY = 0x2 ，二进制数据.
30 |      */
31 |     public function getOpcode(): int;
32 | 
33 |     /**
34 |      * 表示数据帧是否完整.
35 |      */
36 |     public function isFinish(): bool;
37 | 
38 |     /**
39 |      * 获取客户端地址
40 |      */
41 |     public function getClientAddress(): IPEndPoint;
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Middleware/IMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Middleware;
 6 | 
 7 | use Imi\Server\WebSocket\IMessageHandler;
 8 | use Imi\Server\WebSocket\Message\IFrame;
 9 | 
10 | interface IMiddleware
11 | {
12 |     public function process(IFrame $frame, IMessageHandler $handler): mixed;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Parser/WSControllerParser.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Parser;
 6 | 
 7 | use Imi\Bean\Parser\BaseParser;
 8 | use Imi\Server\WebSocket\Route\Annotation\WSController;
 9 | use Imi\Util\Traits\TServerAnnotationParser;
10 | 
11 | /**
12 |  * 控制器注解处理器.
13 |  */
14 | class WSControllerParser extends BaseParser
15 | {
16 |     use TServerAnnotationParser;
17 | 
18 |     public function __construct()
19 |     {
20 |         $this->controllerAnnotationClass = WSController::class;
21 |     }
22 | 
23 |     /**
24 |      * {@inheritDoc}
25 |      */
26 |     public function parse(\Imi\Bean\Annotation\Base $annotation, string $className, string $target, string $targetName): void
27 |     {
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Route/Annotation/WSAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * WebSocket 动作注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_METHOD)]
14 | #[Parser(className: \Imi\Server\WebSocket\Parser\WSControllerParser::class)]
15 | class WSAction extends Base
16 | {
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Route/Annotation/WSConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * WebSocket 配置注解
12 |  * 写在 http 控制器的动作方法.
13 |  */
14 | #[\Attribute(\Attribute::TARGET_METHOD)]
15 | #[Parser(className: \Imi\Server\Http\Parser\ControllerParser::class)]
16 | class WSConfig extends Base
17 | {
18 |     public function __construct(
19 |         /**
20 |          * 处理器类.
21 |          */
22 |         public ?string $parserClass = null,
23 |         /**
24 |          * 该动作仅作为 websocket 动作，握手失败则返回 400 错误.
25 |          */
26 |         public bool $wsOnly = true
27 |     ) {
28 |     }
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Route/Annotation/WSController.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * WebSocket 控制器注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Server\WebSocket\Parser\WSControllerParser::class)]
15 | class WSController extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * http 路由；如果设置，则只有握手指定 http 路由，才可以触发该 WebSocket 路由.
20 |          */
21 |         public ?string $route = null,
22 |         /**
23 |          * 指定当前控制器允许哪些服务器使用；支持字符串或数组，默认为 null 则不限制.
24 |          *
25 |          * @var string|string[]|null
26 |          */
27 |         public $server = null
28 |     ) {
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Route/Annotation/WSMiddleware.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * 中间件注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Server\WebSocket\Parser\WSControllerParser::class)]
15 | class WSMiddleware extends Base
16 | {
17 |     public function __construct(
18 |         /**
19 |          * 中间件类或数组.
20 |          *
21 |          * @var string|string[]
22 |          */
23 |         public $middlewares = null
24 |     ) {
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Route/Annotation/WSRoute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Route\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | use Imi\Bean\Annotation\Parser;
 9 | 
10 | /**
11 |  * WebSocket 路由注解.
12 |  */
13 | #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
14 | #[Parser(className: \Imi\Server\WebSocket\Parser\WSControllerParser::class)]
15 | class WSRoute extends Base implements \Stringable
16 | {
17 |     public function __toString(): string
18 |     {
19 |         return http_build_query($this->toArray());
20 |     }
21 | 
22 |     public function __construct(
23 |         /**
24 |          * 条件.
25 |          */
26 |         public array $condition = [],
27 |         /**
28 |          * http 路由；如果设置，则只有握手指定 http 路由，才可以触发该 WebSocket 路由.
29 |          */
30 |         public ?string $route = null
31 |     ) {
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Route/IRoute.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Route;
 6 | 
 7 | interface IRoute
 8 | {
 9 |     /**
10 |      * 路由解析处理.
11 |      */
12 |     public function parse(mixed $data): ?RouteResult;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Route/RouteItem.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Route;
 6 | 
 7 | use Imi\Server\WebSocket\Route\Annotation\WSRoute;
 8 | 
 9 | class RouteItem
10 | {
11 |     /**
12 |      * 回调.
13 |      *
14 |      * @var callable
15 |      */
16 |     public $callable;
17 | 
18 |     /**
19 |      * 中间件列表.
20 |      */
21 |     public array $middlewares = [];
22 | 
23 |     public function __construct(
24 |         /**
25 |          * 注解.
26 |          */
27 |         public ?WSRoute $annotation, callable $callable,
28 |         /**
29 |          * 其它配置项.
30 |          */
31 |         public array $options = [])
32 |     {
33 |         $this->callable = $callable;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Server/WebSocket/Route/RouteResult.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Server\WebSocket\Route;
 6 | 
 7 | class RouteResult
 8 | {
 9 |     /**
10 |      * 回调.
11 |      *
12 |      * @var callable
13 |      */
14 |     public $callable;
15 | 
16 |     public function __construct(
17 |         /**
18 |          * 路由配置项.
19 |          */
20 |         public ?RouteItem $routeItem,
21 |         /**
22 |          * 参数.
23 |          */
24 |         public array $params = [])
25 |     {
26 |         $this->callable = $routeItem->callable;
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Timer/Contract/ITimer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Timer\Contract;
 6 | 
 7 | interface ITimer
 8 | {
 9 |     /**
10 |      * 定时器，无限执行.
11 |      */
12 |     public function tick(int $ms, callable $callback): int;
13 | 
14 |     /**
15 |      * 定时器，只执行一次
16 |      */
17 |     public function after(int $ms, callable $callback): int;
18 | 
19 |     /**
20 |      * 删除定时器.
21 |      */
22 |     public function del(int $id): void;
23 | 
24 |     /**
25 |      * 清空所有定时器.
26 |      */
27 |     public function clear(): void;
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Timer/Handler/DefaultTimer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Timer\Handler;
 6 | 
 7 | use Imi\Bean\Annotation\Bean;
 8 | use Imi\Timer\Contract\ITimer;
 9 | 
10 | /**
11 |  * 默认定时器，无定时功能，立即执行.
12 |  *
13 |  * @codeCoverageIgnore
14 |  */
15 | #[Bean(name: 'DefaultTimer')]
16 | class DefaultTimer implements ITimer
17 | {
18 |     /**
19 |      * {@inheritDoc}
20 |      */
21 |     public function tick(int $ms, callable $callback): int
22 |     {
23 |         throw new \RuntimeException('Unsupport tick timer');
24 |     }
25 | 
26 |     /**
27 |      * {@inheritDoc}
28 |      */
29 |     public function after(int $ms, callable $callback): int
30 |     {
31 |         throw new \RuntimeException('Unsupport after timer');
32 |     }
33 | 
34 |     /**
35 |      * {@inheritDoc}
36 |      */
37 |     public function del(int $id): void
38 |     {
39 |         throw new \RuntimeException('Unsupport del timer');
40 |     }
41 | 
42 |     /**
43 |      * {@inheritDoc}
44 |      */
45 |     public function clear(): void
46 |     {
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Util/Bit.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util;
 6 | 
 7 | /**
 8 |  * 位操作工具类.
 9 |  */
10 | class Bit
11 | {
12 |     use \Imi\Util\Traits\TStaticClass;
13 | 
14 |     /**
15 |      * 判断是否包含值
16 |      */
17 |     public static function has(int $value, int $subValue): bool
18 |     {
19 |         return $value === $subValue || ($subValue === ($value & $subValue));
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Util/Digital.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util;
 6 | 
 7 | /**
 8 |  * 数字相关工具类.
 9 |  */
10 | class Digital
11 | {
12 |     use \Imi\Util\Traits\TStaticClass;
13 | 
14 |     /**
15 |      * 科学计数转小数形式的.
16 |      *
17 |      * @param string $num       科学计数法字符串  如 2.1E-5
18 |      * @param int    $precision 小数点保留位数 默认5位
19 |      */
20 |     public static function scientificToNum(string $num, int $precision = 5): string
21 |     {
22 |         if (false !== stripos($num, 'e'))
23 |         {
24 |             $a = explode('e', strtolower($num));
25 | 
26 |             return bcmul($a[0], bcpow('10', $a[1], $precision), $precision);
27 |         }
28 | 
29 |         return $num;
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Util/DocBlock.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util;
 6 | 
 7 | use phpDocumentor\Reflection\DocBlock as RealDocBlock;
 8 | use phpDocumentor\Reflection\DocBlockFactory;
 9 | use phpDocumentor\Reflection\Location;
10 | use phpDocumentor\Reflection\Types\Context;
11 | 
12 | class DocBlock
13 | {
14 |     use \Imi\Util\Traits\TStaticClass;
15 | 
16 |     private static ?DocBlockFactory $factory = null;
17 | 
18 |     public static function getFactory(): DocBlockFactory
19 |     {
20 |         if (null === self::$factory)
21 |         {
22 |             // @phpstan-ignore-next-line
23 |             return self::$factory = DocBlockFactory::createInstance();
24 |         }
25 | 
26 |         return self::$factory;
27 |     }
28 | 
29 |     /**
30 |      * @param object|string $docblock a string containing the DocBlock to parse or an object supporting the getDocComment method (such as a ReflectionClass object)
31 |      */
32 |     public static function getDocBlock($docblock, ?Context $context = null, ?Location $location = null): RealDocBlock
33 |     {
34 |         return self::getFactory()->create($docblock, $context, $location);
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Util/EnumUtil.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util;
 6 | 
 7 | use Imi\Util\Traits\TStaticClass;
 8 | 
 9 | class EnumUtil
10 | {
11 |     use TStaticClass;
12 | 
13 |     public static function fromName(string $enum, string $case): \UnitEnum
14 |     {
15 |         $result = static::tryFromName($enum, $case);
16 |         if ($result)
17 |         {
18 |             return $result;
19 |         }
20 |         throw new \ValueError('"' . $case . '" is not a valid name for enum "' . static::class . '"');
21 |     }
22 | 
23 |     public static function tryFromName(string $enum, string $case): ?\UnitEnum
24 |     {
25 |         foreach ($enum::cases() as $c)
26 |         {
27 |             if ($c->name === $case)
28 |             {
29 |                 return $c;
30 |             }
31 |         }
32 | 
33 |         return null;
34 |     }
35 | 
36 |     public static function in(string $enum, mixed $value): bool
37 |     {
38 |         foreach ($enum::cases() as $case)
39 |         {
40 |             if ($case === $value || ($case->value ?? $case->name) === $value)
41 |             {
42 |                 return true;
43 |             }
44 |         }
45 | 
46 |         return false;
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Util/Format/IFormat.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Format;
 6 | 
 7 | interface IFormat
 8 | {
 9 |     /**
10 |      * 编码为存储格式.
11 |      */
12 |     public function encode(mixed $data): string;
13 | 
14 |     /**
15 |      * 解码为php变量.
16 |      */
17 |     public function decode(string $data): mixed;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Util/Format/Json.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Format;
 6 | 
 7 | class Json implements IFormat
 8 | {
 9 |     /**
10 |      * {@inheritDoc}
11 |      */
12 |     public function encode(mixed $data): string
13 |     {
14 |         return json_encode($data, \JSON_THROW_ON_ERROR | \JSON_UNESCAPED_SLASHES | \JSON_UNESCAPED_UNICODE);
15 |     }
16 | 
17 |     /**
18 |      * {@inheritDoc}
19 |      */
20 |     public function decode(string $data): mixed
21 |     {
22 |         return json_decode($data, true, 512, \JSON_THROW_ON_ERROR);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Util/Format/PhpSerialize.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Format;
 6 | 
 7 | class PhpSerialize implements IFormat
 8 | {
 9 |     /**
10 |      * {@inheritDoc}
11 |      */
12 |     public function encode(mixed $data): string
13 |     {
14 |         return serialize($data);
15 |     }
16 | 
17 |     /**
18 |      * {@inheritDoc}
19 |      */
20 |     public function decode(string $data): mixed
21 |     {
22 |         return unserialize($data);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Util/Format/PhpSession.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Format;
 6 | 
 7 | class PhpSession implements IFormat
 8 | {
 9 |     /**
10 |      * {@inheritDoc}
11 |      */
12 |     public function encode(mixed $data): string
13 |     {
14 |         $result = '';
15 |         foreach ($data as $k => $v)
16 |         {
17 |             $result .= $k . '|' . serialize($v);
18 |         }
19 | 
20 |         return $result;
21 |     }
22 | 
23 |     /**
24 |      * {@inheritDoc}
25 |      */
26 |     public function decode(string $data): mixed
27 |     {
28 |         $result = [];
29 |         $offset = 0;
30 |         $length = \strlen($data);
31 |         while ($offset < $length)
32 |         {
33 |             if (!strstr(substr($data, $offset), '|'))
34 |             {
35 |                 return [];
36 |             }
37 |             $pos = strpos($data, '|', $offset);
38 |             $num = $pos - $offset;
39 |             $varname = substr($data, $offset, $num);
40 |             $offset += $num + 1;
41 |             $dataItem = unserialize(substr($data, $offset));
42 |             $result[$varname] = $dataItem;
43 |             $offset += \strlen(serialize($dataItem));
44 |         }
45 | 
46 |         return $result;
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Util/Http/Consts/RequestMethod.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Http\Consts;
 6 | 
 7 | /**
 8 |  * 常见的http请求方法.
 9 |  */
10 | class RequestMethod
11 | {
12 |     use \Imi\Util\Traits\TStaticClass;
13 | 
14 |     public const GET = 'GET';
15 | 
16 |     public const POST = 'POST';
17 | 
18 |     public const HEAD = 'HEAD';
19 | 
20 |     public const PUT = 'PUT';
21 | 
22 |     public const PATCH = 'PATCH';
23 | 
24 |     public const DELETE = 'DELETE';
25 | 
26 |     public const OPTIONS = 'OPTIONS';
27 | 
28 |     public const TRACE = 'TRACE';
29 | }
30 | 


--------------------------------------------------------------------------------
/src/Util/Http/MessageUtil.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Http;
 6 | 
 7 | class MessageUtil
 8 | {
 9 |     /**
10 |      * 处理消息的 getHeaders() 方法返回值
11 |      * 键值对应数组，值从数组变为字符串.
12 |      */
13 |     public static function headersToStringList(array $headers): array
14 |     {
15 |         $result = [];
16 |         foreach ($headers as $name => $values)
17 |         {
18 |             $result[$name] = implode(', ', $values);
19 |         }
20 | 
21 |         return $result;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Util/ImiPriority.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util;
 6 | 
 7 | /**
 8 |  * 优先级定义
 9 |  * 19940312 代表的是宇润的生日.
10 |  */
11 | class ImiPriority
12 | {
13 |     use \Imi\Util\Traits\TStaticClass;
14 | 
15 |     /**
16 |      * 优先级最小值
17 |      */
18 |     public const MIN = \PHP_INT_MIN;
19 | 
20 |     /**
21 |      * 优先级最大值
22 |      */
23 |     public const MAX = \PHP_INT_MAX;
24 | 
25 |     /**
26 |      * 框架用到的最小优先级
27 |      * 小于这个值，可以后于框架最小优先级执行.
28 |      */
29 |     public const IMI_MIN = -19940312;
30 | 
31 |     /**
32 |      * 框架用到的最大优先级
33 |      * 大于这个值，可以先于框架最大优先级执行.
34 |      */
35 |     public const IMI_MAX = 19940312;
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Util/Interfaces/IArrayable.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Interfaces;
 6 | 
 7 | interface IArrayable
 8 | {
 9 |     /**
10 |      * 将当前对象作为数组返回.
11 |      */
12 |     public function toArray(): array;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Util/Interfaces/IHashCode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Interfaces;
 6 | 
 7 | interface IHashCode
 8 | {
 9 |     public function hashCode(): string;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Util/LazyArrayObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util;
 6 | 
 7 | /**
 8 |  * 同时可以作为数组和对象访问的类.
 9 |  */
10 | class LazyArrayObject extends \ArrayObject implements \JsonSerializable
11 | {
12 |     public function __construct(mixed $input = [], int $flags = self::ARRAY_AS_PROPS, string $iteratorClass = \ArrayIterator::class)
13 |     {
14 |         parent::__construct($input, $flags, $iteratorClass);
15 |     }
16 | 
17 |     /**
18 |      * {@inheritDoc}
19 |      */
20 |     public function jsonSerialize(): mixed
21 |     {
22 |         return $this->getArrayCopy();
23 |     }
24 | 
25 |     /**
26 |      * 将当前对象作为数组返回.
27 |      */
28 |     public function toArray(): array
29 |     {
30 |         return $this->getArrayCopy();
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Util/MemoryTable/IMemoryTableOption.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\MemoryTable;
 6 | 
 7 | /**
 8 |  * 内存表配置.
 9 |  */
10 | interface IMemoryTableOption
11 | {
12 |     /**
13 |      * 获取配置.
14 |      */
15 |     public function getOption(?array $option = null): array;
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Util/Process.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util;
 6 | 
 7 | class Process
 8 | {
 9 |     use \Imi\Util\Traits\TStaticClass;
10 | 
11 |     public static function isTtySupported(): bool
12 |     {
13 |         return '/' === \DIRECTORY_SEPARATOR && stream_isatty(\STDOUT);
14 |     }
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Util/Process/ProcessAppContexts.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Process;
 6 | 
 7 | /**
 8 |  * 进程相关的应用上下文名称定义.
 9 |  */
10 | class ProcessAppContexts
11 | {
12 |     use \Imi\Util\Traits\TStaticClass;
13 | 
14 |     /**
15 |      * 进程类型.
16 |      */
17 |     public const PROCESS_TYPE = 'process_type';
18 | 
19 |     /**
20 |      * 进程名称.
21 |      */
22 |     public const PROCESS_NAME = 'process_name';
23 | 
24 |     /**
25 |      * 主进程pid.
26 |      */
27 |     public const MASTER_PID = 'master_pid';
28 | 
29 |     /**
30 |      * 当前进程脚本名称.
31 |      */
32 |     public const SCRIPT_NAME = 'script_name';
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Util/Process/ProcessType.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Process;
 6 | 
 7 | /**
 8 |  * 进程类型.
 9 |  */
10 | class ProcessType
11 | {
12 |     use \Imi\Util\Traits\TStaticClass;
13 | 
14 |     /**
15 |      * master 进程.
16 |      */
17 |     public const MASTER = 'master';
18 | 
19 |     /**
20 |      * manager 进程.
21 |      */
22 |     public const MANAGER = 'manager';
23 | 
24 |     /**
25 |      * worker 进程.
26 |      */
27 |     public const WORKER = 'worker';
28 | 
29 |     /**
30 |      * task worker 进程.
31 |      */
32 |     public const TASK_WORKER = 'task_worker';
33 | 
34 |     /**
35 |      * 进程.
36 |      */
37 |     public const PROCESS = 'process';
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Util/Socket/IPEndPoint.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Socket;
 6 | 
 7 | /**
 8 |  * IP 端点.
 9 |  */
10 | class IPEndPoint implements \Stringable
11 | {
12 |     public function __construct(
13 |         /**
14 |          * 地址
15 |          */
16 |         private readonly string $address,
17 |         /**
18 |          * 端口.
19 |          */
20 |         private readonly int $port
21 |     ) {
22 |     }
23 | 
24 |     public function __toString(): string
25 |     {
26 |         return $this->address . ':' . $this->port;
27 |     }
28 | 
29 |     /**
30 |      * 获取地址
31 |      */
32 |     public function getAddress(): string
33 |     {
34 |         return $this->address;
35 |     }
36 | 
37 |     /**
38 |      * 获取端口.
39 |      */
40 |     public function getPort(): int
41 |     {
42 |         return $this->port;
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Util/StaticValueStorage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util;
 6 | 
 7 | final class StaticValueStorage
 8 | {
 9 |     public static array $realClassNames = [];
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Util/Traits/TAnonymous.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Traits;
 6 | 
 7 | use Imi\Util\ClassObject;
 8 | 
 9 | trait TAnonymous
10 | {
11 |     protected static function __getRealClassName(): string
12 |     {
13 |         if (ClassObject::isAnymous(static::class))
14 |         {
15 |             return get_parent_class(static::class);
16 |         }
17 |         else
18 |         {
19 |             return static::class;
20 |         }
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Util/Traits/TBeanRealClass.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Traits;
 6 | 
 7 | use Imi\Bean\BeanFactory;
 8 | use Imi\Util\StaticValueStorage;
 9 | 
10 | trait TBeanRealClass
11 | {
12 |     /**
13 |      * 获取当前Bean类真实类名.
14 |      */
15 |     protected static function __getRealClassName(): string
16 |     {
17 |         return StaticValueStorage::$realClassNames[static::class] ??= BeanFactory::getObjectClass(static::class);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Util/Traits/TDataToProperty.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Traits;
 6 | 
 7 | /**
 8 |  * 支持提供一个构造方法，传入 $data 将数据直接赋值到当前对象属性中.
 9 |  */
10 | trait TDataToProperty
11 | {
12 |     public function __construct(array $data)
13 |     {
14 |         if ($data)
15 |         {
16 |             foreach ($data as $k => $v)
17 |             {
18 |                 $this->{$k} = $v;
19 |             }
20 |         }
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Util/Traits/THashCode.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Traits;
 6 | 
 7 | trait THashCode
 8 | {
 9 |     /**
10 |      * hashCode.
11 |      */
12 |     protected ?string $__hashCode = null;
13 | 
14 |     public function hashCode(): string
15 |     {
16 |         $hashCode = &$this->__hashCode;
17 |         if (null === $hashCode)
18 |         {
19 |             $hashCode = spl_object_hash($this);
20 |         }
21 | 
22 |         return $hashCode;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Util/Traits/TNotRequiredDataToProperty.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Traits;
 6 | 
 7 | /**
 8 |  * 支持提供一个构造方法，传入 $data 将数据直接赋值到当前对象属性中，允许不传构造方法参数.
 9 |  */
10 | trait TNotRequiredDataToProperty
11 | {
12 |     public function __construct(array $data = [])
13 |     {
14 |         if ($data)
15 |         {
16 |             foreach ($data as $k => $v)
17 |             {
18 |                 $this->{$k} = $v;
19 |             }
20 |         }
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Util/Traits/TStaticClass.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Util\Traits;
 6 | 
 7 | /**
 8 |  * 静态类.
 9 |  */
10 | trait TStaticClass
11 | {
12 |     /**
13 |      * @codeCoverageIgnore
14 |      */
15 |     private function __construct()
16 |     {
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Validate/Annotation/AutoValidation.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Validate\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 自动验证
11 |  *
12 |  * 作为类注解-在构造方法调用完成后验证，验证失败抛出异常
13 |  * 作为方法注解-在方法被调用前验证，验证失败抛出异常
14 |  */
15 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
16 | class AutoValidation extends Base
17 | {
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Validate/Annotation/Compare.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Validate\Annotation;
 6 | 
 7 | /**
 8 |  * 比较验证
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY | \Attribute::IS_REPEATABLE)]
11 | class Compare extends Condition
12 | {
13 |     public function __construct(
14 |         public ?string $name = null,
15 |         public bool $optional = false,
16 |         public mixed $default = null,
17 |         public bool $inverseResult = false,
18 |         public string $message = '{name} validate failed',
19 |         /**
20 |          * 验证回调.
21 |          */
22 |         public string|array|null $callable = '\\Imi\\Validate\\ValidatorHelper::compare',
23 |         public array $args = ['{:value}', '{operation}', '{value}'],
24 |         public ?string $exception = null,
25 |         public ?int $exCode = null,
26 |         /**
27 |          * 被比较值
28 |          */
29 |         public mixed $value = null,
30 |         /**
31 |          * 比较符，使用顺序：name代表的值->比较符->被比较值；允许使用：==、!=、===、!==、<、<=、>、>=.
32 |          */
33 |         public string $operation = '=='
34 |     ) {
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Validate/Annotation/Decimal.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Validate\Annotation;
 6 | 
 7 | /**
 8 |  * 小数验证
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY | \Attribute::IS_REPEATABLE)]
11 | class Decimal extends Condition
12 | {
13 |     public function __construct(
14 |         public ?string $name = null,
15 |         public bool $optional = false,
16 |         public mixed $default = null,
17 |         public bool $inverseResult = false,
18 |         public string $message = '{name} validate failed',
19 |         /**
20 |          * 验证回调.
21 |          */
22 |         public string|array|null $callable = '\\Imi\\Validate\\ValidatorHelper::decimal',
23 |         public array $args = ['{:value}', '{min}', '{max}', '{accuracy}'],
24 |         public ?string $exception = null,
25 |         public ?int $exCode = null,
26 |         /**
27 |          * 最小值，为null不限制.
28 |          */
29 |         public ?float $min = null,
30 |         /**
31 |          * 最大值，为null不限制.
32 |          */
33 |         public ?float $max = null,
34 |         /**
35 |          * 小数精度位数，为null不限制.
36 |          */
37 |         public ?int $accuracy = null
38 |     ) {
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Validate/Annotation/InEnum.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Validate\Annotation;
 6 | 
 7 | /**
 8 |  * 枚举验证
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY | \Attribute::IS_REPEATABLE)]
11 | class InEnum extends Condition
12 | {
13 |     public function __construct(
14 |         public ?string $name = null,
15 |         public bool $optional = false,
16 |         public mixed $default = null,
17 |         public bool $inverseResult = false,
18 |         public string $message = '{name} validate failed',
19 |         /**
20 |          * 验证回调.
21 |          */
22 |         public string|array|null $callable = '\\Imi\\Validate\\ValidatorHelper::inEnum',
23 |         public array $args = ['{:value}', '{enum}'],
24 |         public ?string $exception = null,
25 |         public ?int $exCode = null,
26 |         /**
27 |          * 注解类名.
28 |          */
29 |         public string $enum = ''
30 |     ) {
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Validate/Annotation/InList.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Validate\Annotation;
 6 | 
 7 | /**
 8 |  * 列表验证
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY | \Attribute::IS_REPEATABLE)]
11 | class InList extends Condition
12 | {
13 |     public function __construct(
14 |         public ?string $name = null,
15 |         public bool $optional = false,
16 |         public mixed $default = null,
17 |         public bool $inverseResult = false,
18 |         public string $message = '{name} validate failed',
19 |         /**
20 |          * 验证回调.
21 |          */
22 |         public string|array|null $callable = '\\Imi\\Validate\\ValidatorHelper::in',
23 |         public array $args = ['{:value}', '{list}'],
24 |         public ?string $exception = null,
25 |         public ?int $exCode = null,
26 |         /**
27 |          * 列表.
28 |          */
29 |         public array $list = []
30 |     ) {
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Validate/Annotation/Integer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Validate\Annotation;
 6 | 
 7 | /**
 8 |  * 整数验证
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY | \Attribute::IS_REPEATABLE)]
11 | class Integer extends Condition
12 | {
13 |     public function __construct(
14 |         public ?string $name = null,
15 |         public bool $optional = false,
16 |         public mixed $default = null,
17 |         public bool $inverseResult = false,
18 |         public string $message = '{name} validate failed',
19 |         /**
20 |          * 验证回调.
21 |          */
22 |         public string|array|null $callable = '\\Imi\\Validate\\ValidatorHelper::int',
23 |         public array $args = ['{:value}', '{min}', '{max}'],
24 |         public ?string $exception = null,
25 |         public ?int $exCode = null,
26 |         /**
27 |          * 最小值，为null不限制.
28 |          */
29 |         public ?int $min = null,
30 |         /**
31 |          * 最大值，为null不限制.
32 |          */
33 |         public ?int $max = null
34 |     ) {
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Validate/Annotation/Regex.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Validate\Annotation;
 6 | 
 7 | /**
 8 |  * 正则验证
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY | \Attribute::IS_REPEATABLE)]
11 | class Regex extends Condition
12 | {
13 |     public function __construct(
14 |         public ?string $name = null,
15 |         public bool $optional = false,
16 |         public mixed $default = null,
17 |         public bool $inverseResult = false,
18 |         public string $message = '{name} validate failed',
19 |         /**
20 |          * 验证回调.
21 |          */
22 |         public string|array|null $callable = '\\Imi\\Validate\\ValidatorHelper::regex',
23 |         public array $args = ['{:value}', '{pattern}'],
24 |         public ?string $exception = null,
25 |         public ?int $exCode = null,
26 |         /**
27 |          * 正则表达式文本.
28 |          */
29 |         public string $pattern = ''
30 |     ) {
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Validate/Annotation/Required.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Validate\Annotation;
 6 | 
 7 | /**
 8 |  * 必选参数.
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY | \Attribute::IS_REPEATABLE)]
11 | class Required extends Condition
12 | {
13 |     public function __construct(public ?string $name = null, public bool $optional = false, public mixed $default = null, public bool $inverseResult = false, public string $message = '{name} validate failed', public string|array|null $callable = '\\Imi\\Util\\ObjectArrayHelper::exists', public array $args = ['{:data}', '{name}'], public ?string $exception = null, public ?int $exCode = null)
14 |     {
15 |     }
16 | }
17 | 


--------------------------------------------------------------------------------
/src/Validate/Annotation/Scene.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Validate\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 场景定义.
11 |  */
12 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::IS_REPEATABLE)]
13 | class Scene extends Base
14 | {
15 |     public function __construct(
16 |         /**
17 |          * 场景名称.
18 |          */
19 |         public string $name = '',
20 |         /**
21 |          * 需要验证的字段名列表.
22 |          */
23 |         public array $fields = []
24 |     ) {
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Validate/Annotation/Text.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Validate\Annotation;
 6 | 
 7 | /**
 8 |  * 文本验证
 9 |  */
10 | #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY | \Attribute::IS_REPEATABLE)]
11 | class Text extends Condition
12 | {
13 |     public function __construct(
14 |         public ?string $name = null,
15 |         public bool $optional = false,
16 |         public mixed $default = null,
17 |         public bool $inverseResult = false,
18 |         public string $message = '{name} validate failed',
19 |         /**
20 |          * 验证回调.
21 |          */
22 |         public string|array|null $callable = '\\Imi\\Validate\\ValidatorHelper::text',
23 |         public array $args = ['{:value}', '{min}', '{max}', '{char}'],
24 |         public ?string $exception = null,
25 |         public ?int $exCode = null,
26 |         /**
27 |          * 是否为字符模式，默认为 false；设为 true 则使用字符判断长度；设为 false 则使用字节判断长度.
28 |          */
29 |         public bool $char = false,
30 |         /**
31 |          * 最短长度.
32 |          */
33 |         public int $min = 0,
34 |         /**
35 |          * 最长长度，为null则不限制长度.
36 |          */
37 |         public ?int $max = null
38 |     ) {
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Validate/Annotation/ValidateValue.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Imi\Validate\Annotation;
 6 | 
 7 | use Imi\Bean\Annotation\Base;
 8 | 
 9 | /**
10 |  * 验证时的值
11 |  */
12 | #[\Attribute]
13 | class ValidateValue extends Base
14 | {
15 |     public function __construct(
16 |         /**
17 |          * 值规则；支持代入{:value}原始值；支持代入{:data.xxx}所有数据中的某项.
18 |          */
19 |         public string $value = ''
20 |     ) {
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------