File manager - Edit - /var/www/payraty/helpdesk/public/storage/branding_media/images/src.zip
Back
PK ! �(�� � Token.phpnu ȯ�� <?php declare(strict_types=1); namespace Doctrine\Common\Lexer; use UnitEnum; use function in_array; /** * @template T of UnitEnum|string|int * @template V of string|int */ final class Token { /** * The string value of the token in the input string * * @readonly * @var V */ public string|int $value; /** * The type of the token (identifier, numeric, string, input parameter, none) * * @readonly * @var T|null */ public $type; /** * The position of the token in the input string * * @readonly */ public int $position; /** * @param V $value * @param T|null $type */ public function __construct(string|int $value, $type, int $position) { $this->value = $value; $this->type = $type; $this->position = $position; } /** @param T ...$types */ public function isA(...$types): bool { return in_array($this->type, $types, true); } } PK ! ��� AbstractLexer.phpnu ȯ�� <?php declare(strict_types=1); namespace Doctrine\Common\Lexer; use ReflectionClass; use UnitEnum; use function implode; use function preg_split; use function sprintf; use function substr; use const PREG_SPLIT_DELIM_CAPTURE; use const PREG_SPLIT_NO_EMPTY; use const PREG_SPLIT_OFFSET_CAPTURE; /** * Base class for writing simple lexers, i.e. for creating small DSLs. * * @template T of UnitEnum|string|int * @template V of string|int */ abstract class AbstractLexer { /** * Lexer original input string. */ private string $input; /** * Array of scanned tokens. * * @var list<Token<T, V>> */ private array $tokens = []; /** * Current lexer position in input string. */ private int $position = 0; /** * Current peek of current lexer position. */ private int $peek = 0; /** * The next token in the input. * * @var Token<T, V>|null */ public Token|null $lookahead; /** * The last matched/seen token. * * @var Token<T, V>|null */ public Token|null $token; /** * Composed regex for input parsing. * * @var non-empty-string|null */ private string|null $regex = null; /** * Sets the input data to be tokenized. * * The Lexer is immediately reset and the new input tokenized. * Any unprocessed tokens from any previous input are lost. * * @param string $input The input to be tokenized. * * @return void */ public function setInput(string $input) { $this->input = $input; $this->tokens = []; $this->reset(); $this->scan($input); } /** * Resets the lexer. * * @return void */ public function reset() { $this->lookahead = null; $this->token = null; $this->peek = 0; $this->position = 0; } /** * Resets the peek pointer to 0. * * @return void */ public function resetPeek() { $this->peek = 0; } /** * Resets the lexer position on the input to the given position. * * @param int $position Position to place the lexical scanner. * * @return void */ public function resetPosition(int $position = 0) { $this->position = $position; } /** * Retrieve the original lexer's input until a given position. * * @return string */ public function getInputUntilPosition(int $position) { return substr($this->input, 0, $position); } /** * Checks whether a given token matches the current lookahead. * * @param T $type * * @return bool * * @psalm-assert-if-true !=null $this->lookahead */ public function isNextToken(int|string|UnitEnum $type) { return $this->lookahead !== null && $this->lookahead->isA($type); } /** * Checks whether any of the given tokens matches the current lookahead. * * @param list<T> $types * * @return bool * * @psalm-assert-if-true !=null $this->lookahead */ public function isNextTokenAny(array $types) { return $this->lookahead !== null && $this->lookahead->isA(...$types); } /** * Moves to the next token in the input string. * * @return bool * * @psalm-assert-if-true !null $this->lookahead */ public function moveNext() { $this->peek = 0; $this->token = $this->lookahead; $this->lookahead = isset($this->tokens[$this->position]) ? $this->tokens[$this->position++] : null; return $this->lookahead !== null; } /** * Tells the lexer to skip input tokens until it sees a token with the given value. * * @param T $type The token type to skip until. * * @return void */ public function skipUntil(int|string|UnitEnum $type) { while ($this->lookahead !== null && ! $this->lookahead->isA($type)) { $this->moveNext(); } } /** * Checks if given value is identical to the given token. * * @return bool */ public function isA(string $value, int|string|UnitEnum $token) { return $this->getType($value) === $token; } /** * Moves the lookahead token forward. * * @return Token<T, V>|null The next token or NULL if there are no more tokens ahead. */ public function peek() { if (isset($this->tokens[$this->position + $this->peek])) { return $this->tokens[$this->position + $this->peek++]; } return null; } /** * Peeks at the next token, returns it and immediately resets the peek. * * @return Token<T, V>|null The next token or NULL if there are no more tokens ahead. */ public function glimpse() { $peek = $this->peek(); $this->peek = 0; return $peek; } /** * Scans the input string for tokens. * * @param string $input A query string. * * @return void */ protected function scan(string $input) { if (! isset($this->regex)) { $this->regex = sprintf( '/(%s)|%s/%s', implode(')|(', $this->getCatchablePatterns()), implode('|', $this->getNonCatchablePatterns()), $this->getModifiers(), ); } $flags = PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_OFFSET_CAPTURE; $matches = preg_split($this->regex, $input, -1, $flags); if ($matches === false) { // Work around https://bugs.php.net/78122 $matches = [[$input, 0]]; } foreach ($matches as $match) { // Must remain before 'value' assignment since it can change content $firstMatch = $match[0]; $type = $this->getType($firstMatch); $this->tokens[] = new Token( $firstMatch, $type, $match[1], ); } } /** * Gets the literal for a given token. * * @param T $token * * @return int|string */ public function getLiteral(int|string|UnitEnum $token) { if ($token instanceof UnitEnum) { return $token::class . '::' . $token->name; } $className = static::class; $reflClass = new ReflectionClass($className); $constants = $reflClass->getConstants(); foreach ($constants as $name => $value) { if ($value === $token) { return $className . '::' . $name; } } return $token; } /** * Regex modifiers * * @return string */ protected function getModifiers() { return 'iu'; } /** * Lexical catchable patterns. * * @return string[] */ abstract protected function getCatchablePatterns(); /** * Lexical non-catchable patterns. * * @return string[] */ abstract protected function getNonCatchablePatterns(); /** * Retrieve token type. Also processes the token value if necessary. * * @return T|null * * @param-out V $value */ abstract protected function getType(string &$value); } PK ! �7E lib/RpcServer.phpnu ȯ�� <?php /* * * Copyright 2020 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * This is an experimental and incomplete implementation of gRPC server * for PHP. APIs are _definitely_ going to be changed. * * DO NOT USE in production. */ /** * Class RpcServer * @package Grpc */ class RpcServer extends Server { // [ <String method_full_path> => MethodDescriptor ] private $paths_map = []; private function waitForNextEvent() { return $this->requestCall(); } /** * Add a service to this server * * @param Object $service The service to be added */ public function handle($service) { $methodDescriptors = $service->getMethodDescriptors(); $exist_methods = array_intersect_key($this->paths_map, $methodDescriptors); if (!empty($exist_methods)) { fwrite(STDERR, "WARNING: " . 'override already registered methods: ' . implode(', ', array_keys($exist_methods)) . PHP_EOL); } $this->paths_map = array_merge($this->paths_map, $methodDescriptors); return $this->paths_map; } public function run() { $this->start(); while (true) try { // This blocks until the server receives a request $event = $this->waitForNextEvent(); $full_path = $event->method; $context = new ServerContext($event); $server_writer = new ServerCallWriter($event->call, $context); if (!array_key_exists($full_path, $this->paths_map)) { $context->setStatus(Status::unimplemented()); $server_writer->finish(); continue; }; $method_desc = $this->paths_map[$full_path]; $server_reader = new ServerCallReader( $event->call, $method_desc->request_type ); try { $this->processCall( $method_desc, $server_reader, $server_writer, $context ); } catch (\Exception $e) { $context->setStatus(Status::status( STATUS_INTERNAL, $e->getMessage() )); $server_writer->finish(); } } catch (\Exception $e) { fwrite(STDERR, "ERROR: " . $e->getMessage() . PHP_EOL); exit(1); } } private function processCall( MethodDescriptor $method_desc, ServerCallReader $server_reader, ServerCallWriter $server_writer, ServerContext $context ) { // Dispatch to actual server logic switch ($method_desc->call_type) { case MethodDescriptor::UNARY_CALL: $request = $server_reader->read(); $response = call_user_func( array($method_desc->service, $method_desc->method_name), $request ?? new $method_desc->request_type, $context ); $server_writer->finish($response); break; case MethodDescriptor::SERVER_STREAMING_CALL: $request = $server_reader->read(); call_user_func( array($method_desc->service, $method_desc->method_name), $request ?? new $method_desc->request_type, $server_writer, $context ); break; case MethodDescriptor::CLIENT_STREAMING_CALL: $response = call_user_func( array($method_desc->service, $method_desc->method_name), $server_reader, $context ); $server_writer->finish($response); break; case MethodDescriptor::BIDI_STREAMING_CALL: call_user_func( array($method_desc->service, $method_desc->method_name), $server_reader, $server_writer, $context ); break; default: throw new \Exception(); } } } PK ! �Bs? ? lib/ClientStreamingCall.phpnu ȯ�� <?php /* * * Copyright 2015 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * Represents an active call that sends a stream of messages and then gets * a single response. */ class ClientStreamingCall extends AbstractCall { /** * Start the call. * * @param array $metadata Metadata to send with the call, if applicable * (optional) */ public function start(array $metadata = []) { $this->call->startBatch([ OP_SEND_INITIAL_METADATA => $metadata, ]); } /** * Write a single message to the server. This cannot be called after * wait is called. * * @param ByteBuffer $data The data to write * @param array $options An array of options, possible keys: * 'flags' => a number (optional) */ public function write($data, array $options = []) { $message_array = ['message' => $this->_serializeMessage($data)]; if (array_key_exists('flags', $options)) { $message_array['flags'] = $options['flags']; } $this->call->startBatch([ OP_SEND_MESSAGE => $message_array, ]); } /** * Wait for the server to respond with data and a status. * * @return array [response data, status] */ public function wait() { $event = $this->call->startBatch([ OP_SEND_CLOSE_FROM_CLIENT => true, OP_RECV_INITIAL_METADATA => true, OP_RECV_MESSAGE => true, OP_RECV_STATUS_ON_CLIENT => true, ]); $this->metadata = $event->metadata; $status = $event->status; $this->trailing_metadata = $status->metadata; return [$this->_deserializeResponse($event->message), $status]; } } PK ! ���� � lib/ServerCallWriter.phpnu ȯ�� <?php /* * * Copyright 2020 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * This is an experimental and incomplete implementation of gRPC server * for PHP. APIs are _definitely_ going to be changed. * * DO NOT USE in production. */ class ServerCallWriter { public function __construct($call, $serverContext) { $this->call_ = $call; $this->serverContext_ = $serverContext; } public function start( $data = null, array $options = [] ) { $batch = []; $this->addSendInitialMetadataOpIfNotSent( $batch, $this->serverContext_->initialMetadata() ); $this->addSendMessageOpIfHasData($batch, $data, $options); $this->call_->startBatch($batch); } public function write( $data, array $options = [] ) { $batch = []; $this->addSendInitialMetadataOpIfNotSent( $batch, $this->serverContext_->initialMetadata() ); $this->addSendMessageOpIfHasData($batch, $data, $options); $this->call_->startBatch($batch); } public function finish( $data = null, array $options = [] ) { $batch = [ OP_SEND_STATUS_FROM_SERVER => $this->serverContext_->status() ?? Status::ok(), OP_RECV_CLOSE_ON_SERVER => true, ]; $this->addSendInitialMetadataOpIfNotSent( $batch, $this->serverContext_->initialMetadata() ); $this->addSendMessageOpIfHasData($batch, $data, $options); $this->call_->startBatch($batch); } //////////////////////////// private function addSendInitialMetadataOpIfNotSent( array &$batch, array $initialMetadata = null ) { if (!$this->initialMetadataSent_) { $batch[OP_SEND_INITIAL_METADATA] = $initialMetadata ?? []; $this->initialMetadataSent_ = true; } } private function addSendMessageOpIfHasData( array &$batch, $data = null, array $options = [] ) { if ($data) { $message_array = ['message' => $data->serializeToString()]; if (array_key_exists('flags', $options)) { $message_array['flags'] = $options['flags']; } $batch[OP_SEND_MESSAGE] = $message_array; } } private $call_; private $initialMetadataSent_ = false; private $serverContext_; } PK ! B �i i lib/Interceptor.phpnu ȯ�� <?php /* * * Copyright 2018 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * Represents an interceptor that intercept RPC invocations before call starts. * There is one proposal related to the argument $deserialize under the review. * The proposal link is https://github.com/grpc/proposal/pull/86. */ class Interceptor { public function interceptUnaryUnary( $method, $argument, $deserialize, $continuation, array $metadata = [], array $options = [] ) { return $continuation($method, $argument, $deserialize, $metadata, $options); } public function interceptStreamUnary( $method, $deserialize, $continuation, array $metadata = [], array $options = [] ) { return $continuation($method, $deserialize, $metadata, $options); } public function interceptUnaryStream( $method, $argument, $deserialize, $continuation, array $metadata = [], array $options = [] ) { return $continuation($method, $argument, $deserialize, $metadata, $options); } public function interceptStreamStream( $method, $deserialize, $continuation, array $metadata = [], array $options = [] ) { return $continuation($method, $deserialize, $metadata, $options); } /** * Intercept the methods with Channel * * @param Channel|InterceptorChannel $channel An already created Channel or InterceptorChannel object (optional) * @param Interceptor|Interceptor[] $interceptors interceptors to be added * * @return InterceptorChannel */ public static function intercept($channel, $interceptors) { if (is_array($interceptors)) { for ($i = count($interceptors) - 1; $i >= 0; $i--) { $channel = new Internal\InterceptorChannel($channel, $interceptors[$i]); } } else { $channel = new Internal\InterceptorChannel($channel, $interceptors); } return $channel; } } PK ! g�hW lib/UnaryCall.phpnu ȯ�� <?php /* * * Copyright 2015 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * Represents an active call that sends a single message and then gets a * single response. */ class UnaryCall extends AbstractCall { /** * Start the call. * * @param mixed $data The data to send * @param array $metadata Metadata to send with the call, if applicable * (optional) * @param array $options An array of options, possible keys: * 'flags' => a number (optional) */ public function start($data, array $metadata = [], array $options = []) { $message_array = ['message' => $this->_serializeMessage($data)]; if (isset($options['flags'])) { $message_array['flags'] = $options['flags']; } $this->call->startBatch([ OP_SEND_INITIAL_METADATA => $metadata, OP_SEND_MESSAGE => $message_array, OP_SEND_CLOSE_FROM_CLIENT => true, ]); } /** * Wait for the server to respond with data and a status. * * @return array [response data, status] */ public function wait() { $batch = [ OP_RECV_MESSAGE => true, OP_RECV_STATUS_ON_CLIENT => true, ]; if ($this->metadata === null) { $batch[OP_RECV_INITIAL_METADATA] = true; } $event = $this->call->startBatch($batch); if ($this->metadata === null) { $this->metadata = $event->metadata; } $status = $event->status; $this->trailing_metadata = $status->metadata; return [$this->_deserializeResponse($event->message), $status]; } /** * @return mixed The metadata sent by the server */ public function getMetadata() { if ($this->metadata === null) { $event = $this->call->startBatch([OP_RECV_INITIAL_METADATA => true]); $this->metadata = $event->metadata; } return $this->metadata; } } PK ! �� lib/ServerStreamingCall.phpnu ȯ�� <?php /* * * Copyright 2015 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * Represents an active call that sends a single message and then gets a * stream of responses. */ class ServerStreamingCall extends AbstractCall { /** * Start the call. * * @param mixed $data The data to send * @param array $metadata Metadata to send with the call, if applicable * (optional) * @param array $options An array of options, possible keys: * 'flags' => a number (optional) */ public function start($data, array $metadata = [], array $options = []) { $message_array = ['message' => $this->_serializeMessage($data)]; if (array_key_exists('flags', $options)) { $message_array['flags'] = $options['flags']; } $this->call->startBatch([ OP_SEND_INITIAL_METADATA => $metadata, OP_SEND_MESSAGE => $message_array, OP_SEND_CLOSE_FROM_CLIENT => true, ]); } /** * @return mixed An iterator of response values */ public function responses() { $batch = [OP_RECV_MESSAGE => true]; if ($this->metadata === null) { $batch[OP_RECV_INITIAL_METADATA] = true; } $read_event = $this->call->startBatch($batch); if ($this->metadata === null) { $this->metadata = $read_event->metadata; } $response = $read_event->message; while ($response !== null) { yield $this->_deserializeResponse($response); $response = $this->call->startBatch([ OP_RECV_MESSAGE => true, ])->message; } } /** * Wait for the server to send the status, and return it. * * @return \stdClass The status object, with integer $code, string * $details, and array $metadata members */ public function getStatus() { $status_event = $this->call->startBatch([ OP_RECV_STATUS_ON_CLIENT => true, ]); $this->trailing_metadata = $status_event->status->metadata; return $status_event->status; } /** * @return mixed The metadata sent by the server */ public function getMetadata() { if ($this->metadata === null) { $event = $this->call->startBatch([OP_RECV_INITIAL_METADATA => true]); $this->metadata = $event->metadata; } return $this->metadata; } } PK ! p?-� � lib/CallInvoker.phpnu ȯ�� <?php /* * * Copyright 2018 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * CallInvoker is used to pass the self defined channel into the stub, * while intercept each RPC with the channel accessible. */ interface CallInvoker { public function createChannelFactory($hostname, $opts); public function UnaryCall($channel, $method, $deserialize, $options); public function ClientStreamingCall($channel, $method, $deserialize, $options); public function ServerStreamingCall($channel, $method, $deserialize, $options); public function BidiStreamingCall($channel, $method, $deserialize, $options); } PK ! ��R R # lib/Internal/InterceptorChannel.phpnu ȯ�� <?php /* * * Copyright 2018 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc\Internal; /** * This is a PRIVATE API and can change without notice. */ class InterceptorChannel extends \Grpc\Channel { private $next = null; private $interceptor; /** * @param Channel|InterceptorChannel $channel An already created Channel * or InterceptorChannel object (optional) * @param Interceptor $interceptor */ public function __construct($channel, $interceptor) { if (!is_a($channel, 'Grpc\Channel') && !is_a($channel, 'Grpc\Internal\InterceptorChannel')) { throw new \Exception('The channel argument is not a Channel object '. 'or an InterceptorChannel object created by '. 'Interceptor::intercept($channel, Interceptor|Interceptor[] $interceptors)'); } $this->interceptor = $interceptor; $this->next = $channel; } public function getNext() { return $this->next; } public function getInterceptor() { return $this->interceptor; } public function getTarget() { return $this->getNext()->getTarget(); } public function watchConnectivityState($new_state, $deadline) { return $this->getNext()->watchConnectivityState($new_state, $deadline); } public function getConnectivityState($try_to_connect = false) { return $this->getNext()->getConnectivityState($try_to_connect); } public function close() { return $this->getNext()->close(); } } PK ! ��i �R �R lib/BaseStub.phpnu ȯ�� <?php /* * * Copyright 2015 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * Base class for generated client stubs. Stub methods are expected to call * _simpleRequest or _streamRequest and return the result. */ class BaseStub { private $hostname; private $hostname_override; private $channel; private $call_invoker; // a callback function private $update_metadata; /** * @param string $hostname * @param array $opts * - 'update_metadata': (optional) a callback function which takes in a * metadata array, and returns an updated metadata array * - 'grpc.primary_user_agent': (optional) a user-agent string * @param Channel|InterceptorChannel $channel An already created Channel or InterceptorChannel object (optional) */ public function __construct($hostname, $opts, $channel = null) { if (!method_exists('Grpc\ChannelCredentials', 'isDefaultRootsPemSet') || !ChannelCredentials::isDefaultRootsPemSet()) { $ssl_roots = file_get_contents( dirname(__FILE__).'/../../etc/roots.pem' ); ChannelCredentials::setDefaultRootsPem($ssl_roots); } $this->hostname = $hostname; $this->update_metadata = null; if (isset($opts['update_metadata'])) { if (is_callable($opts['update_metadata'])) { $this->update_metadata = $opts['update_metadata']; } unset($opts['update_metadata']); } if (!empty($opts['grpc.ssl_target_name_override'])) { $this->hostname_override = $opts['grpc.ssl_target_name_override']; } if (isset($opts['grpc_call_invoker'])) { $this->call_invoker = $opts['grpc_call_invoker']; unset($opts['grpc_call_invoker']); $channel_opts = $this->updateOpts($opts); // If the grpc_call_invoker is defined, use the channel created by the call invoker. $this->channel = $this->call_invoker->createChannelFactory($hostname, $channel_opts); return; } $this->call_invoker = new DefaultCallInvoker(); if ($channel) { if (!is_a($channel, 'Grpc\Channel') && !is_a($channel, 'Grpc\Internal\InterceptorChannel')) { throw new \Exception('The channel argument is not a Channel object '. 'or an InterceptorChannel object created by '. 'Interceptor::intercept($channel, Interceptor|Interceptor[] $interceptors)'); } $this->channel = $channel; return; } $this->channel = static::getDefaultChannel($hostname, $opts); } private static function updateOpts($opts) { if (!empty($opts['grpc.primary_user_agent'])) { $opts['grpc.primary_user_agent'] .= ' '; } else { $opts['grpc.primary_user_agent'] = ''; } if (defined('\Grpc\VERSION')) { $version_str = \Grpc\VERSION; } else { if (!file_exists($composerFile = __DIR__.'/../../composer.json')) { // for grpc/grpc-php subpackage $composerFile = __DIR__.'/../composer.json'; } $package_config = json_decode(file_get_contents($composerFile), true); $version_str = $package_config['version']; } $opts['grpc.primary_user_agent'] .= 'grpc-php/'.$version_str; if (!array_key_exists('credentials', $opts)) { throw new \Exception("The opts['credentials'] key is now ". 'required. Please see one of the '. 'ChannelCredentials::create methods'); } return $opts; } /** * Creates and returns the default Channel * * @param array $opts Channel constructor options * * @return Channel The channel */ public static function getDefaultChannel($hostname, array $opts) { $channel_opts = self::updateOpts($opts); return new Channel($hostname, $channel_opts); } /** * @return string The URI of the endpoint */ public function getTarget() { return $this->channel->getTarget(); } /** * @param bool $try_to_connect (optional) * * @return int The grpc connectivity state */ public function getConnectivityState($try_to_connect = false) { return $this->channel->getConnectivityState($try_to_connect); } /** * @param int $timeout in microseconds * * @return bool true if channel is ready * @throws Exception if channel is in FATAL_ERROR state */ public function waitForReady($timeout) { $new_state = $this->getConnectivityState(true); if ($this->_checkConnectivityState($new_state)) { return true; } $now = Timeval::now(); $delta = new Timeval($timeout); $deadline = $now->add($delta); while ($this->channel->watchConnectivityState($new_state, $deadline)) { // state has changed before deadline $new_state = $this->getConnectivityState(); if ($this->_checkConnectivityState($new_state)) { return true; } } // deadline has passed $new_state = $this->getConnectivityState(); return $this->_checkConnectivityState($new_state); } /** * Close the communication channel associated with this stub. */ public function close() { $this->channel->close(); } /** * @param $new_state Connect state * * @return bool true if state is CHANNEL_READY * @throws Exception if state is CHANNEL_FATAL_FAILURE */ private function _checkConnectivityState($new_state) { if ($new_state == \Grpc\CHANNEL_READY) { return true; } if ($new_state == \Grpc\CHANNEL_FATAL_FAILURE) { throw new \Exception('Failed to connect to server'); } return false; } /** * constructs the auth uri for the jwt. * * @param string $method The method string * * @return string The URL string */ private function _get_jwt_aud_uri($method) { // TODO(jtattermusch): This is not the correct implementation // of extracting JWT "aud" claim. We should rely on // grpc_metadata_credentials_plugin which // also provides the correct value of "aud" claim // in the grpc_auth_metadata_context.service_url field. // Trying to do the construction of "aud" field ourselves // is bad. $last_slash_idx = strrpos($method, '/'); if ($last_slash_idx === false) { throw new \InvalidArgumentException( 'service name must have a slash' ); } $service_name = substr($method, 0, $last_slash_idx); if ($this->hostname_override) { $hostname = $this->hostname_override; } else { $hostname = $this->hostname; } // Remove the port if it is 443 // See https://github.com/grpc/grpc/blob/07c9f7a36b2a0d34fcffebc85649cf3b8c339b5d/src/core/lib/security/transport/client_auth_filter.cc#L205 if ((strlen($hostname) > 4) && (substr($hostname, -4) === ":443")) { $hostname = substr($hostname, 0, -4); } return 'https://'.$hostname.$service_name; } /** * validate and normalize the metadata array. * * @param array $metadata The metadata map * * @return array $metadata Validated and key-normalized metadata map * @throws InvalidArgumentException if key contains invalid characters */ private function _validate_and_normalize_metadata($metadata) { $metadata_copy = []; foreach ($metadata as $key => $value) { if (!preg_match('/^[.A-Za-z\d_-]+$/', $key)) { throw new \InvalidArgumentException( 'Metadata keys must be nonempty strings containing only '. 'alphanumeric characters, hyphens, underscores and dots' ); } $metadata_copy[strtolower($key)] = $value; } return $metadata_copy; } /** * Create a function which can be used to create UnaryCall * * @param Channel|InterceptorChannel $channel * @param callable $deserialize A function that deserializes the response * * @return \Closure */ private function _GrpcUnaryUnary($channel) { return function ($method, $argument, $deserialize, array $metadata = [], array $options = []) use ($channel) { $call = $this->call_invoker->UnaryCall( $channel, $method, $deserialize, $options ); $jwt_aud_uri = $this->_get_jwt_aud_uri($method); if (is_callable($this->update_metadata)) { $metadata = call_user_func( $this->update_metadata, $metadata, $jwt_aud_uri ); } $metadata = $this->_validate_and_normalize_metadata( $metadata ); $call->start($argument, $metadata, $options); return $call; }; } /** * Create a function which can be used to create ServerStreamingCall * * @param Channel|InterceptorChannel $channel * @param callable $deserialize A function that deserializes the response * * @return \Closure */ private function _GrpcStreamUnary($channel) { return function ($method, $deserialize, array $metadata = [], array $options = []) use ($channel) { $call = $this->call_invoker->ClientStreamingCall( $channel, $method, $deserialize, $options ); $jwt_aud_uri = $this->_get_jwt_aud_uri($method); if (is_callable($this->update_metadata)) { $metadata = call_user_func( $this->update_metadata, $metadata, $jwt_aud_uri ); } $metadata = $this->_validate_and_normalize_metadata( $metadata ); $call->start($metadata); return $call; }; } /** * Create a function which can be used to create ClientStreamingCall * * @param Channel|InterceptorChannel $channel * @param callable $deserialize A function that deserializes the response * * @return \Closure */ private function _GrpcUnaryStream($channel) { return function ($method, $argument, $deserialize, array $metadata = [], array $options = []) use ($channel) { $call = $this->call_invoker->ServerStreamingCall( $channel, $method, $deserialize, $options ); $jwt_aud_uri = $this->_get_jwt_aud_uri($method); if (is_callable($this->update_metadata)) { $metadata = call_user_func( $this->update_metadata, $metadata, $jwt_aud_uri ); } $metadata = $this->_validate_and_normalize_metadata( $metadata ); $call->start($argument, $metadata, $options); return $call; }; } /** * Create a function which can be used to create BidiStreamingCall * * @param Channel|InterceptorChannel $channel * @param callable $deserialize A function that deserializes the response * * @return \Closure */ private function _GrpcStreamStream($channel) { return function ($method, $deserialize, array $metadata = [], array $options = []) use ($channel) { $call = $this->call_invoker->BidiStreamingCall( $channel, $method, $deserialize, $options ); $jwt_aud_uri = $this->_get_jwt_aud_uri($method); if (is_callable($this->update_metadata)) { $metadata = call_user_func( $this->update_metadata, $metadata, $jwt_aud_uri ); } $metadata = $this->_validate_and_normalize_metadata( $metadata ); $call->start($metadata); return $call; }; } /** * Create a function which can be used to create UnaryCall * * @param Channel|InterceptorChannel $channel * @param callable $deserialize A function that deserializes the response * * @return \Closure */ private function _UnaryUnaryCallFactory($channel) { if (is_a($channel, 'Grpc\Internal\InterceptorChannel')) { return function ($method, $argument, $deserialize, array $metadata = [], array $options = []) use ($channel) { return $channel->getInterceptor()->interceptUnaryUnary( $method, $argument, $deserialize, $this->_UnaryUnaryCallFactory($channel->getNext()), $metadata, $options ); }; } return $this->_GrpcUnaryUnary($channel); } /** * Create a function which can be used to create ServerStreamingCall * * @param Channel|InterceptorChannel $channel * @param callable $deserialize A function that deserializes the response * * @return \Closure */ private function _UnaryStreamCallFactory($channel) { if (is_a($channel, 'Grpc\Internal\InterceptorChannel')) { return function ($method, $argument, $deserialize, array $metadata = [], array $options = []) use ($channel) { return $channel->getInterceptor()->interceptUnaryStream( $method, $argument, $deserialize, $this->_UnaryStreamCallFactory($channel->getNext()), $metadata, $options ); }; } return $this->_GrpcUnaryStream($channel); } /** * Create a function which can be used to create ClientStreamingCall * * @param Channel|InterceptorChannel $channel * @param callable $deserialize A function that deserializes the response * * @return \Closure */ private function _StreamUnaryCallFactory($channel) { if (is_a($channel, 'Grpc\Internal\InterceptorChannel')) { return function ($method, $deserialize, array $metadata = [], array $options = []) use ($channel) { return $channel->getInterceptor()->interceptStreamUnary( $method, $deserialize, $this->_StreamUnaryCallFactory($channel->getNext()), $metadata, $options ); }; } return $this->_GrpcStreamUnary($channel); } /** * Create a function which can be used to create BidiStreamingCall * * @param Channel|InterceptorChannel $channel * @param callable $deserialize A function that deserializes the response * * @return \Closure */ private function _StreamStreamCallFactory($channel) { if (is_a($channel, 'Grpc\Internal\InterceptorChannel')) { return function ($method, $deserialize, array $metadata = [], array $options = []) use ($channel) { return $channel->getInterceptor()->interceptStreamStream( $method, $deserialize, $this->_StreamStreamCallFactory($channel->getNext()), $metadata, $options ); }; } return $this->_GrpcStreamStream($channel); } /* This class is intended to be subclassed by generated code, so * all functions begin with "_" to avoid name collisions. */ /** * Call a remote method that takes a single argument and has a * single output. * * @param string $method The name of the method to call * @param mixed $argument The argument to the method * @param callable $deserialize A function that deserializes the response * @param array $metadata A metadata map to send to the server * (optional) * @param array $options An array of options (optional) * * @return UnaryCall The active call object */ protected function _simpleRequest( $method, $argument, $deserialize, array $metadata = [], array $options = [] ) { $call_factory = $this->_UnaryUnaryCallFactory($this->channel); $call = $call_factory($method, $argument, $deserialize, $metadata, $options); return $call; } /** * Call a remote method that takes a stream of arguments and has a single * output. * * @param string $method The name of the method to call * @param callable $deserialize A function that deserializes the response * @param array $metadata A metadata map to send to the server * (optional) * @param array $options An array of options (optional) * * @return ClientStreamingCall The active call object */ protected function _clientStreamRequest( $method, $deserialize, array $metadata = [], array $options = [] ) { $call_factory = $this->_StreamUnaryCallFactory($this->channel); $call = $call_factory($method, $deserialize, $metadata, $options); return $call; } /** * Call a remote method that takes a single argument and returns a stream * of responses. * * @param string $method The name of the method to call * @param mixed $argument The argument to the method * @param callable $deserialize A function that deserializes the responses * @param array $metadata A metadata map to send to the server * (optional) * @param array $options An array of options (optional) * * @return ServerStreamingCall The active call object */ protected function _serverStreamRequest( $method, $argument, $deserialize, array $metadata = [], array $options = [] ) { $call_factory = $this->_UnaryStreamCallFactory($this->channel); $call = $call_factory($method, $argument, $deserialize, $metadata, $options); return $call; } /** * Call a remote method with messages streaming in both directions. * * @param string $method The name of the method to call * @param callable $deserialize A function that deserializes the responses * @param array $metadata A metadata map to send to the server * (optional) * @param array $options An array of options (optional) * * @return BidiStreamingCall The active call object */ protected function _bidiRequest( $method, $deserialize, array $metadata = [], array $options = [] ) { $call_factory = $this->_StreamStreamCallFactory($this->channel); $call = $call_factory($method, $deserialize, $metadata, $options); return $call; } } PK ! �ꒁ� � lib/Status.phpnu ȯ�� <?php /* * * Copyright 2020 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * This is an experimental and incomplete implementation of gRPC server * for PHP. APIs are _definitely_ going to be changed. * * DO NOT USE in production. */ /** * Class Status * @package Grpc */ class Status { public static function status(int $code, string $details, array $metadata = null): array { $status = [ 'code' => $code, 'details' => $details, ]; if ($metadata) { $status['metadata'] = $metadata; } return $status; } public static function ok(array $metadata = null): array { return Status::status(STATUS_OK, 'OK', $metadata); } public static function unimplemented(): array { return Status::status(STATUS_UNIMPLEMENTED, 'UNIMPLEMENTED'); } } PK ! �n � � lib/ServerContext.phpnu ȯ�� <?php /* * * Copyright 2020 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * This is an experimental and incomplete implementation of gRPC server * for PHP. APIs are _definitely_ going to be changed. * * DO NOT USE in production. */ class ServerContext { public function __construct($event) { $this->event = $event; } public function clientMetadata() { return $this->event->metadata; } public function deadline() { return $this->event->absolute_deadline; } public function host() { return $this->event->host; } public function method() { return $this->event->method; } public function setInitialMetadata($initialMetadata) { $this->initialMetadata_ = $initialMetadata; } public function initialMetadata() { return $this->initialMetadata_; } public function setStatus($status) { $this->status_ = $status; } public function status() { return $this->status_; } private $event; private $initialMetadata_; private $status_; } PK ! Ӵ�Tv v lib/MethodDescriptor.phpnu ȯ�� <?php /* * * Copyright 2020 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * This is an experimental and incomplete implementation of gRPC server * for PHP. APIs are _definitely_ going to be changed. * * DO NOT USE in production. */ class MethodDescriptor { public function __construct( object $service, string $method_name, string $request_type, int $call_type ) { $this->service = $service; $this->method_name = $method_name; $this->request_type = $request_type; $this->call_type = $call_type; } public const UNARY_CALL = 0; public const SERVER_STREAMING_CALL = 1; public const CLIENT_STREAMING_CALL = 2; public const BIDI_STREAMING_CALL = 3; public $service; public $method_name; public $request_type; public $call_type; } PK ! ��� � lib/BidiStreamingCall.phpnu ȯ�� <?php /* * * Copyright 2015 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * Represents an active call that allows for sending and receiving messages * in streams in any order. */ class BidiStreamingCall extends AbstractCall { /** * Start the call. * * @param array $metadata Metadata to send with the call, if applicable * (optional) */ public function start(array $metadata = []) { $this->call->startBatch([ OP_SEND_INITIAL_METADATA => $metadata, ]); } /** * Reads the next value from the server. * * @return mixed The next value from the server, or null if there is none */ public function read() { $batch = [OP_RECV_MESSAGE => true]; if ($this->metadata === null) { $batch[OP_RECV_INITIAL_METADATA] = true; } $read_event = $this->call->startBatch($batch); if ($this->metadata === null) { $this->metadata = $read_event->metadata; } return $this->_deserializeResponse($read_event->message); } /** * Write a single message to the server. This cannot be called after * writesDone is called. * * @param ByteBuffer $data The data to write * @param array $options An array of options, possible keys: * 'flags' => a number (optional) */ public function write($data, array $options = []) { $message_array = ['message' => $this->_serializeMessage($data)]; if (array_key_exists('flags', $options)) { $message_array['flags'] = $options['flags']; } $this->call->startBatch([ OP_SEND_MESSAGE => $message_array, ]); } /** * Indicate that no more writes will be sent. */ public function writesDone() { $this->call->startBatch([ OP_SEND_CLOSE_FROM_CLIENT => true, ]); } /** * Wait for the server to send the status, and return it. * * @return \stdClass The status object, with integer $code, string * $details, and array $metadata members */ public function getStatus() { $status_event = $this->call->startBatch([ OP_RECV_STATUS_ON_CLIENT => true, ]); $this->trailing_metadata = $status_event->status->metadata; return $status_event->status; } } PK ! v��͢ � lib/AbstractCall.phpnu ȯ�� <?php /* * * Copyright 2015 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * Class AbstractCall. * @package Grpc */ abstract class AbstractCall { /** * @var Call */ protected $call; protected $deserialize; protected $metadata; protected $trailing_metadata; /** * Create a new Call wrapper object. * * @param Channel $channel The channel to communicate on * @param string $method The method to call on the * remote server * @param callback $deserialize A callback function to deserialize * the response * @param array $options Call options (optional) */ public function __construct(Channel $channel, $method, $deserialize, array $options = []) { if (array_key_exists('timeout', $options) && is_numeric($timeout = $options['timeout']) ) { $now = Timeval::now(); $delta = new Timeval($timeout); $deadline = $now->add($delta); } else { $deadline = Timeval::infFuture(); } $this->call = new Call($channel, $method, $deadline); $this->deserialize = $deserialize; $this->metadata = null; $this->trailing_metadata = null; if (array_key_exists('call_credentials_callback', $options) && is_callable($call_credentials_callback = $options['call_credentials_callback']) ) { $call_credentials = CallCredentials::createFromPlugin( $call_credentials_callback ); $this->call->setCredentials($call_credentials); } } /** * @return mixed The metadata sent by the server */ public function getMetadata() { return $this->metadata; } /** * @return mixed The trailing metadata sent by the server */ public function getTrailingMetadata() { return $this->trailing_metadata; } /** * @return string The URI of the endpoint */ public function getPeer() { return $this->call->getPeer(); } /** * Cancels the call. */ public function cancel() { $this->call->cancel(); } /** * Serialize a message to the protobuf binary format. * * @param mixed $data The Protobuf message * * @return string The protobuf binary format */ protected function _serializeMessage($data) { // Proto3 implementation return $data->serializeToString(); } /** * Deserialize a response value to an object. * * @param string $value The binary value to deserialize * * @return mixed The deserialized value */ protected function _deserializeResponse($value) { if ($value === null) { return; } list($className, $deserializeFunc) = $this->deserialize; $obj = new $className(); $obj->mergeFromString($value); return $obj; } /** * Set the CallCredentials for the underlying Call. * * @param CallCredentials $call_credentials The CallCredentials object */ public function setCallCredentials($call_credentials) { $this->call->setCredentials($call_credentials); } } PK ! ��к= = lib/ServerCallReader.phpnu ȯ�� <?php /* * * Copyright 2020 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * This is an experimental and incomplete implementation of gRPC server * for PHP. APIs are _definitely_ going to be changed. * * DO NOT USE in production. */ class ServerCallReader { public function __construct($call, string $request_type) { $this->call_ = $call; $this->request_type_ = $request_type; } public function read() { $event = $this->call_->startBatch([ OP_RECV_MESSAGE => true, ]); if ($event->message === null) { return null; } $data = new $this->request_type_; $data->mergeFromString($event->message); return $data; } private $call_; private $request_type_; } PK ! �IC� � lib/DefaultCallInvoker.phpnu ȯ�� <?php /* * * Copyright 2018 gRPC authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ namespace Grpc; /** * Default call invoker in the gRPC stub. */ class DefaultCallInvoker implements CallInvoker { public function createChannelFactory($hostname, $opts) { return new Channel($hostname, $opts); } public function UnaryCall($channel, $method, $deserialize, $options) { return new UnaryCall($channel, $method, $deserialize, $options); } public function ClientStreamingCall($channel, $method, $deserialize, $options) { return new ClientStreamingCall($channel, $method, $deserialize, $options); } public function ServerStreamingCall($channel, $method, $deserialize, $options) { return new ServerStreamingCall($channel, $method, $deserialize, $options); } public function BidiStreamingCall($channel, $method, $deserialize, $options) { return new BidiStreamingCall($channel, $method, $deserialize, $options); } } PK ! ���� � WaitTimeCalculator.phpnu ȯ�� <?php namespace Laravel\Horizon; use Illuminate\Contracts\Queue\Factory as QueueFactory; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\MetricsRepository; use Laravel\Horizon\Contracts\SupervisorRepository; class WaitTimeCalculator { /** * The queue factory implementation. * * @var \Illuminate\Contracts\Queue\Factory */ public $queue; /** * The supervisor repository implementation. * * @var \Laravel\Horizon\Contracts\SupervisorRepository */ public $supervisors; /** * The metrics repository implementation. * * @var \Laravel\Horizon\Contracts\MetricsRepository */ public $metrics; /** * Create a new calculator instance. * * @param \Illuminate\Contracts\Queue\Factory $queue * @param \Laravel\Horizon\Contracts\SupervisorRepository $supervisors * @param \Laravel\Horizon\Contracts\MetricsRepository $metrics * @return void */ public function __construct(QueueFactory $queue, SupervisorRepository $supervisors, MetricsRepository $metrics) { $this->queue = $queue; $this->metrics = $metrics; $this->supervisors = $supervisors; } /** * Calculate the time to clear a given queue in seconds. * * @param string $queue * @return float */ public function calculateFor($queue) { return array_values($this->calculate($queue))[0] ?? 0; } /** * Calculate the time to clear per queue in seconds. * * @param string|null $queue * @return array */ public function calculate($queue = null) { $queues = $this->queueNames( $supervisors = collect($this->supervisors->all()), $queue ); return $queues->mapWithKeys(function ($queue) use ($supervisors) { $totalProcesses = $this->totalProcessesFor($supervisors, $queue); [$connection, $queueName] = explode(':', $queue, 2); return [$queue => $this->calculateTimeToClear($connection, $queueName, $totalProcesses)]; })->sort()->reverse()->all(); } /** * Get all of the queue names. * * @param \Illuminate\Support\Collection $supervisors * @param string|null $queue * @return \Illuminate\Support\Collection */ protected function queueNames($supervisors, $queue = null) { $queues = $supervisors->map(function ($supervisor) { return array_keys($supervisor->processes); })->collapse()->unique()->values(); return $queue ? $queues->intersect([$queue]) : $queues; } /** * Get the total process count for a given queue. * * @param \Illuminate\Support\Collection $allSupervisors * @param string $queue * @return int */ protected function totalProcessesFor($allSupervisors, $queue) { return $allSupervisors->sum(function ($supervisor) use ($queue) { return $supervisor->processes[$queue] ?? 0; }); } /** * Calculate the time to clear for the given queue in seconds distributed over the given amount of processes. * * @param string $connection * @param string $queue * @param int $totalProcesses * @return int */ public function calculateTimeToClear($connection, $queue, $totalProcesses) { $timeToClear = ! Str::contains($queue, ',') ? $this->timeToClearFor($connection, $queue) : collect(explode(',', $queue))->sum(function ($queueName) use ($connection) { return $this->timeToClearFor($connection, $queueName); }); return $totalProcesses === 0 ? round($timeToClear / 1000) : round(($timeToClear / $totalProcesses) / 1000); } /** * Get the total time to clear (in milliseconds) for a given queue. * * @param string $connection * @param string $queue * @return float */ protected function timeToClearFor($connection, $queue) { $size = $this->queue->connection($connection)->readyNow($queue); return $size * $this->metrics->runtimeForQueue($queue); } } PK ! ��5M M " Notifications/LongWaitDetected.phpnu ȯ�� <?php namespace Laravel\Horizon\Notifications; use Illuminate\Bus\Queueable; use Illuminate\Notifications\Messages\MailMessage; use Illuminate\Notifications\Messages\NexmoMessage; use Illuminate\Notifications\Messages\SlackMessage; use Illuminate\Notifications\Notification; use Illuminate\Notifications\Slack\BlockKit\Blocks\SectionBlock; use Illuminate\Notifications\Slack\SlackMessage as ChannelIdSlackMessage; use Illuminate\Support\Str; use Laravel\Horizon\Horizon; class LongWaitDetected extends Notification { use Queueable; /** * The queue connection name. * * @var string */ public $longWaitConnection; /** * The queue name. * * @var string */ public $longWaitQueue; /** * The wait time in seconds. * * @var int */ public $seconds; /** * Create a new notification instance. * * @param string $connection * @param string $queue * @param int $seconds * @return void */ public function __construct($connection, $queue, $seconds) { $this->longWaitQueue = $queue; $this->seconds = $seconds; $this->longWaitConnection = $connection; } /** * Get the notification's delivery channels. * * @param mixed $notifiable * @return array */ public function via($notifiable) { return array_filter([ Horizon::$slackWebhookUrl ? 'slack' : null, Horizon::$smsNumber ? 'nexmo' : null, Horizon::$email ? 'mail' : null, ]); } /** * Get the mail representation of the notification. * * @param mixed $notifiable * @return \Illuminate\Notifications\Messages\MailMessage */ public function toMail($notifiable) { return (new MailMessage) ->error() ->subject(config('app.name').': Long Queue Wait Detected') ->greeting('Oh no! Something needs your attention.') ->line(sprintf( 'The "%s" queue on the "%s" connection has a wait time of %s seconds.', $this->longWaitQueue, $this->longWaitConnection, $this->seconds )); } /** * Get the Slack representation of the notification. * * @param mixed $notifiable * @return \Illuminate\Notifications\Messages\SlackMessage */ public function toSlack($notifiable) { $fromName = 'Laravel Horizon'; $title = 'Long Wait Detected'; $text = 'Oh no! Something needs your attention.'; $imageUrl = 'https://laravel.com/assets/img/horizon-48px.png'; $content = sprintf( '[%s] The "%s" queue on the "%s" connection has a wait time of %s seconds.', config('app.name'), $this->longWaitQueue, $this->longWaitConnection, $this->seconds ); if (class_exists('\Illuminate\Notifications\Slack\SlackMessage') && class_exists('\Illuminate\Notifications\Slack\BlockKit\Blocks\SectionBlock') && ! (is_string(Horizon::$slackWebhookUrl) && Str::startsWith(Horizon::$slackWebhookUrl, ['http://', 'https://']))) { return (new ChannelIdSlackMessage) ->username($fromName) ->image($imageUrl) ->text($text) ->headerBlock($title) ->sectionBlock(function (SectionBlock $block) use ($content): void { // @phpstan-ignore-line $block->text($content); }); } return (new SlackMessage) // @phpstan-ignore-line ->from($fromName) ->to(Horizon::$slackChannel) ->image($imageUrl) ->error() ->content($text) ->attachment(function ($attachment) use ($title, $content) { $attachment->title($title) ->content($content); }); } /** * Get the Nexmo / SMS representation of the notification. * * @param mixed $notifiable * @return \Illuminate\Notifications\Messages\NexmoMessage */ public function toNexmo($notifiable) { return (new NexmoMessage)->content(sprintf( // @phpstan-ignore-line '[%s] The "%s" queue on the "%s" connection has a wait time of %s seconds.', config('app.name'), $this->longWaitQueue, $this->longWaitConnection, $this->seconds )); } /** * The unique signature of the notification. * * @return string */ public function signature() { return md5($this->longWaitConnection.$this->longWaitQueue); } } PK ! x��w w SystemProcessCounter.phpnu ȯ�� <?php namespace Laravel\Horizon; use Symfony\Component\Process\Process; class SystemProcessCounter { /** * The base command to search for. * * @var string */ public static $command = 'horizon:work'; /** * Get the number of Horizon workers for a given supervisor. * * @param string $name * @return int */ public function get($name) { $process = Process::fromShellCommandline('exec ps aux | grep '.static::$command, null, ['COLUMNS' => '2000']); $process->run(); return substr_count($process->getOutput(), 'supervisor='.$name); } } PK ! ��� � # Console/SupervisorStatusCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\MasterSupervisor; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:supervisor-status')] class SupervisorStatusCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:supervisor-status {name : The name of the supervisor}'; /** * The console command description. * * @var string */ protected $description = 'Show the status for a given supervisor'; /** * Execute the console command. * * @param \Laravel\Horizon\Contracts\SupervisorRepository $supervisors * @return void */ public function handle(SupervisorRepository $supervisors) { $name = $this->argument('name'); $supervisorStatus = optional(collect($supervisors->all())->first(function ($supervisor) use ($name) { return Str::startsWith($supervisor->name, MasterSupervisor::basename()) && Str::endsWith($supervisor->name, $name); }))->status; if (is_null($supervisorStatus)) { $this->components->error('Unable to find a supervisor with this name.'); return 1; } $this->components->info("{$name} is {$supervisorStatus}"); } } PK ! �� � Console/PublishCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:publish')] class PublishCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:publish'; /** * The console command description. * * @var string */ protected $description = 'Publish all of the Horizon resources'; /** * Execute the console command. * * @return void */ public function handle() { $this->components->warn('Horizon no longer publishes its assets. You may stop calling the `horizon:publish` command.'); } } PK ! ӱ��� � Console/TimeoutCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Laravel\Horizon\MasterSupervisor; use Laravel\Horizon\ProvisioningPlan; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:timeout')] class TimeoutCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:timeout {environment=production : The environment name}'; /** * The console command description. * * @var string */ protected $description = 'Get the maximum timeout for the given environment'; /** * Indicates whether the command should be shown in the Artisan command list. * * @var bool */ protected $hidden = true; /** * Execute the console command. * * @return void */ public function handle() { $plan = ProvisioningPlan::get(MasterSupervisor::name())->plan; $environment = $this->argument('environment'); $timeout = collect($plan[$this->argument('environment')] ?? [])->max('timeout') ?? 60; $this->components->info('Maximum timeout for '.$environment.' environment: '.$timeout.' seconds.'); } } PK ! ��9�I I Console/TerminateCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Illuminate\Contracts\Cache\Factory as CacheFactory; use Illuminate\Support\Arr; use Illuminate\Support\InteractsWithTime; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\MasterSupervisor; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:terminate')] class TerminateCommand extends Command { use InteractsWithTime; /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:terminate {--wait : Wait for all workers to terminate}'; /** * The console command description. * * @var string */ protected $description = 'Terminate the master supervisor so it can be restarted'; /** * Execute the console command. * * @param \Illuminate\Contracts\Cache\Factory $cache * @param \Laravel\Horizon\Contracts\MasterSupervisorRepository $masters * @return void */ public function handle(CacheFactory $cache, MasterSupervisorRepository $masters) { if (config('horizon.fast_termination')) { $cache->forever( 'horizon:terminate:wait', $this->option('wait') ); } $masters = collect($masters->all())->filter(function ($master) { return Str::startsWith($master->name, MasterSupervisor::basename()); })->all(); collect(Arr::pluck($masters, 'pid')) ->whenNotEmpty(fn () => $this->components->info('Sending TERM signal to processes.')) ->whenEmpty(fn () => $this->components->info('No processes to terminate.')) ->each(function ($processId) { $result = true; $this->components->task("Process: $processId", function () use ($processId, &$result) { return $result = posix_kill($processId, SIGTERM); }); if (! $result) { $this->components->error("Failed to kill process: {$processId} (".posix_strerror(posix_get_last_error()).')'); } })->whenNotEmpty(fn () => $this->output->writeln('')); $this->laravel['cache']->forever('illuminate:queue:restart', $this->currentTime()); } } PK ! �{߯ Console/ClearCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Illuminate\Console\ConfirmableTrait; use Illuminate\Queue\QueueManager; use Illuminate\Support\Arr; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\RedisQueue; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:clear')] class ClearCommand extends Command { use ConfirmableTrait; /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:clear {--queue= : The name of the queue to clear} {--force : Force the operation to run when in production}'; /** * The console command description. * * @var string */ protected $description = 'Delete all of the jobs from the specified queue'; /** * Execute the console command. * * @return int|null */ public function handle(JobRepository $jobRepository, QueueManager $manager) { if (! $this->confirmToProceed()) { return 1; } if (! method_exists(RedisQueue::class, 'clear')) { $this->components->error('Clearing queues is not supported on this version of Laravel.'); return 1; } $connection = Arr::first($this->laravel['config']->get('horizon.defaults'))['connection'] ?? 'redis'; if (method_exists($jobRepository, 'purge')) { $jobRepository->purge($queue = $this->getQueue($connection)); } $count = $manager->connection($connection)->clear($queue); $this->components->info('Cleared '.$count.' jobs from the ['.$queue.'] queue.'); return 0; } /** * Get the queue name to clear. * * @param string $connection * @return string */ protected function getQueue($connection) { return $this->option('queue') ?: $this->laravel['config']->get( "queue.connections.{$connection}.queue", 'default' ); } } PK ! �V�ؤ � Console/PurgeCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\Contracts\ProcessRepository; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\MasterSupervisor; use Laravel\Horizon\ProcessInspector; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:purge')] class PurgeCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:purge {--signal=SIGTERM : The signal to send to the rogue processes}'; /** * The console command description. * * @var string */ protected $description = 'Terminate any rogue Horizon processes'; /** * @var \Laravel\Horizon\Contracts\SupervisorRepository */ private $supervisors; /** * @var \Laravel\Horizon\Contracts\ProcessRepository */ private $processes; /** * @var \Laravel\Horizon\ProcessInspector */ private $inspector; /** * Create a new command instance. * * @param \Laravel\Horizon\Contracts\SupervisorRepository $supervisors * @param \Laravel\Horizon\Contracts\ProcessRepository $processes * @param \Laravel\Horizon\ProcessInspector $inspector * @return void */ public function __construct( SupervisorRepository $supervisors, ProcessRepository $processes, ProcessInspector $inspector ) { parent::__construct(); $this->supervisors = $supervisors; $this->processes = $processes; $this->inspector = $inspector; } /** * Execute the console command. * * @param \Laravel\Horizon\Contracts\MasterSupervisorRepository $masters * @return void */ public function handle(MasterSupervisorRepository $masters) { $signal = is_numeric($signal = $this->option('signal')) ? $signal : constant($signal); foreach ($masters->names() as $master) { if (Str::startsWith($master, MasterSupervisor::basename())) { $this->purge($master, $signal); } } } /** * Purge any orphan processes. * * @param string $master * @param int $signal * @return void */ public function purge($master, $signal = SIGTERM) { $this->recordOrphans($master, $signal); $expired = $this->processes->orphanedFor( $master, $this->supervisors->longestActiveTimeout() ); collect($expired) ->whenNotEmpty(fn () => $this->components->info('Sending TERM signal to expired processes of ['.$master.']')) ->each(function ($processId) use ($master, $signal) { $this->components->task("Process: $processId", function () use ($processId, $signal) { exec("kill -s {$signal} {$processId}"); }); $this->processes->forgetOrphans($master, [$processId]); })->whenNotEmpty(fn () => $this->output->writeln('')); } /** * Record the orphaned Horizon processes. * * @param string $master * @param int $signal * @return void */ protected function recordOrphans($master, $signal) { $this->processes->orphaned( $master, $orphans = $this->inspector->orphaned() ); collect($orphans) ->whenNotEmpty(fn () => $this->components->info('Sending TERM signal to orphaned processes of ['.$master.']')) ->each(function ($processId) use ($signal) { $result = true; $this->components->task("Process: $processId", function () use ($processId, $signal, &$result) { return $result = posix_kill($processId, $signal); }); if (! $result) { $this->components->error("Failed to kill orphan process: {$processId} (".posix_strerror(posix_get_last_error()).')'); } })->whenNotEmpty(fn () => $this->output->writeln('')); } } PK ! _�8 8 Console/ForgetFailedCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Laravel\Horizon\Contracts\JobRepository; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:forget')] class ForgetFailedCommand extends Command { /** * The console command signature. * * @var string */ protected $signature = 'horizon:forget {id? : The ID of the failed job} {--all : Delete all failed jobs}'; /** * The console command description. * * @var string */ protected $description = 'Delete a failed queue job'; /** * Execute the console command. * * @return int|null */ public function handle(JobRepository $repository) { if ($this->option('all')) { $totalFailedCount = $repository->totalFailed(); do { $failedJobs = collect($repository->getFailed()); $failedJobs->pluck('id')->each(function ($failedId) use ($repository): void { $repository->deleteFailed($failedId); if ($this->laravel['queue.failer']->forget($failedId)) { $this->components->info('Failed job (id): '.$failedId.' deleted successfully!'); } }); } while ($repository->totalFailed() !== 0 && $failedJobs->isNotEmpty()); if ($totalFailedCount) { $this->components->info($totalFailedCount.' failed jobs deleted successfully!'); } else { $this->components->info('No failed jobs detected.'); } return; } if (! $this->argument('id')) { $this->components->error('No failed job ID provided.'); } $repository->deleteFailed($this->argument('id')); if ($this->laravel['queue.failer']->forget($this->argument('id'))) { $this->components->info('Failed job deleted successfully!'); } else { $this->components->error('No failed job matches the given ID.'); return 1; } } } PK ! ��� � Console/WorkCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Queue\Console\WorkCommand as BaseWorkCommand; class WorkCommand extends BaseWorkCommand { /** * The console command name. * * @var string */ protected $signature = 'horizon:work {connection? : The name of the queue connection to work} {--name=default : The name of the worker} {--delay=0 : The number of seconds to delay failed jobs (Deprecated)} {--backoff=0 : The number of seconds to wait before retrying a job that encountered an uncaught exception} {--max-jobs=0 : The number of jobs to process before stopping} {--max-time=0 : The maximum number of seconds the worker should run} {--daemon : Run the worker in daemon mode (Deprecated)} {--force : Force the worker to run even in maintenance mode} {--memory=128 : The memory limit in megabytes} {--once : Only process the next job on the queue} {--stop-when-empty : Stop when the queue is empty} {--queue= : The names of the queues to work} {--sleep=3 : Number of seconds to sleep when no job is available} {--rest=0 : Number of seconds to rest between jobs} {--supervisor= : The name of the supervisor the worker belongs to} {--timeout=60 : The number of seconds a child process can run} {--tries=0 : Number of times to attempt a job before logging it failed}'; /** * Indicates whether the command should be shown in the Artisan command list. * * @var bool */ protected $hidden = true; /** * Execute the console command. * * @return void */ public function handle() { if (config('horizon.fast_termination')) { ignore_user_abort(true); } parent::handle(); } } PK ! ̏�, , Console/ContinueCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Illuminate\Support\Arr; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\MasterSupervisor; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:continue')] class ContinueCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:continue'; /** * The console command description. * * @var string */ protected $description = 'Instruct the master supervisor to continue processing jobs'; /** * Execute the console command. * * @param \Laravel\Horizon\Contracts\MasterSupervisorRepository $masters * @return void */ public function handle(MasterSupervisorRepository $masters) { $masters = collect($masters->all())->filter(function ($master) { return Str::startsWith($master->name, MasterSupervisor::basename()); })->all(); collect(Arr::pluck($masters, 'pid')) ->whenNotEmpty(fn () => $this->components->info('Sending CONT signal to processes.')) ->whenEmpty(fn () => $this->components->info('No processes to continue.')) ->each(function ($processId) { $result = true; $this->components->task("Process: $processId", function () use ($processId, &$result) { return $result = posix_kill($processId, SIGCONT); }); if (! $result) { $this->components->error("Failed to kill process: {$processId} (".posix_strerror(posix_get_last_error()).')'); } })->whenNotEmpty(fn () => $this->output->writeln('')); } } PK ! *��E Console/SupervisorsCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Laravel\Horizon\Contracts\SupervisorRepository; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:supervisors')] class SupervisorsCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:supervisors'; /** * The console command description. * * @var string */ protected $description = 'List all of the supervisors'; /** * Execute the console command. * * @param \Laravel\Horizon\Contracts\SupervisorRepository $supervisors * @return void */ public function handle(SupervisorRepository $supervisors) { $supervisors = $supervisors->all(); if (empty($supervisors)) { return $this->components->info('No supervisors are running.'); } $this->output->writeln(''); $this->table([ 'Name', 'PID', 'Status', 'Workers', 'Balancing', ], collect($supervisors)->map(function ($supervisor) { return [ $supervisor->name, $supervisor->pid, $supervisor->status, collect($supervisor->processes)->map(function ($count, $queue) { return $queue.' ('.$count.')'; })->implode(', '), $supervisor->options['balance'], ]; })->all()); $this->output->writeln(''); } } PK ! �z�HZ Z Console/SupervisorCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Exception; use Illuminate\Console\Command; use Laravel\Horizon\SupervisorFactory; use Laravel\Horizon\SupervisorOptions; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:supervisor')] class SupervisorCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:supervisor {name : The name of supervisor} {connection : The name of the connection to work} {--balance= : The balancing strategy the supervisor should apply} {--delay=0 : The number of seconds to delay failed jobs (Deprecated)} {--backoff=0 : The number of seconds to wait before retrying a job that encountered an uncaught exception} {--max-jobs=0 : The number of jobs to process before stopping a child process} {--max-time=0 : The maximum number of seconds a child process should run} {--force : Force the worker to run even in maintenance mode} {--max-processes=1 : The maximum number of total workers to start} {--min-processes=1 : The minimum number of workers to assign per queue} {--memory=128 : The memory limit in megabytes} {--nice=0 : The process priority} {--paused : Start the supervisor in a paused state} {--queue= : The names of the queues to work} {--sleep=3 : Number of seconds to sleep when no job is available} {--timeout=60 : The number of seconds a child process can run} {--tries=0 : Number of times to attempt a job before logging it failed} {--auto-scaling-strategy=time : If supervisor should scale by jobs or time to complete} {--balance-cooldown=3 : The number of seconds to wait in between auto-scaling attempts} {--balance-max-shift=1 : The maximum number of processes to increase or decrease per one scaling} {--workers-name=default : The name that should be assigned to the workers} {--parent-id=0 : The parent process ID} {--rest=0 : Number of seconds to rest between jobs}'; /** * The console command description. * * @var string */ protected $description = 'Start a new supervisor'; /** * Indicates whether the command should be shown in the Artisan command list. * * @var bool */ protected $hidden = true; /** * Execute the console command. * * @param \Laravel\Horizon\SupervisorFactory $factory * @return int|null */ public function handle(SupervisorFactory $factory) { $supervisor = $factory->make( $this->supervisorOptions() ); try { $supervisor->ensureNoDuplicateSupervisors(); } catch (Exception $e) { $this->components->error('A supervisor with this name is already running.'); return 13; } $this->start($supervisor); } /** * Start the given supervisor. * * @param \Laravel\Horizon\Supervisor $supervisor * @return void */ protected function start($supervisor) { if ($supervisor->options->nice) { proc_nice($supervisor->options->nice); } $supervisor->handleOutputUsing(function ($type, $line) { $this->output->write($line); }); $supervisor->working = ! $this->option('paused'); $supervisor->scale(max( 0, $this->option('max-processes') - $supervisor->totalSystemProcessCount() )); $supervisor->monitor(); } /** * Get the supervisor options. * * @return \Laravel\Horizon\SupervisorOptions */ protected function supervisorOptions() { $backoff = $this->hasOption('backoff') ? $this->option('backoff') : $this->option('delay'); $balance = $this->option('balance'); $autoScalingStrategy = $balance === 'auto' ? $this->option('auto-scaling-strategy') : null; return new SupervisorOptions( $this->argument('name'), $this->argument('connection'), $this->getQueue($this->argument('connection')), $this->option('workers-name'), $balance, $backoff, $this->option('max-time'), $this->option('max-jobs'), $this->option('max-processes'), $this->option('min-processes'), $this->option('memory'), $this->option('timeout'), $this->option('sleep'), $this->option('tries'), $this->option('force'), $this->option('nice'), $this->option('balance-cooldown'), $this->option('balance-max-shift'), $this->option('parent-id'), $this->option('rest'), $autoScalingStrategy ); } /** * Get the queue name for the worker. * * @param string $connection * @return string */ protected function getQueue($connection) { return $this->option('queue') ?: $this->laravel['config']->get( "queue.connections.{$connection}.queue", 'default' ); } } PK ! ^�uf f " Console/PauseSupervisorCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\MasterSupervisor; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:pause-supervisor')] class PauseSupervisorCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:pause-supervisor {name : The name of the supervisor to pause}'; /** * The console command description. * * @var string */ protected $description = 'Pause a supervisor'; /** * Execute the console command. * * @param \Laravel\Horizon\Contracts\SupervisorRepository $supervisors * @return void */ public function handle(SupervisorRepository $supervisors) { $processId = optional(collect($supervisors->all())->first(function ($supervisor) { return Str::startsWith($supervisor->name, MasterSupervisor::basename()) && Str::endsWith($supervisor->name, $this->argument('name')); }))->pid; if (is_null($processId)) { $this->components->error('Failed to find a supervisor with this name'); return 1; } $this->components->info("Sending USR2 signal to process: {$processId}"); if (! posix_kill($processId, SIGUSR2)) { $this->components->error("Failed to send USR2 signal to process: {$processId} (".posix_strerror(posix_get_last_error()).')'); } } } PK ! ���F� � % Console/ContinueSupervisorCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\MasterSupervisor; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:continue-supervisor')] class ContinueSupervisorCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:continue-supervisor {name : The name of the supervisor to resume}'; /** * The console command description. * * @var string */ protected $description = 'Instruct the supervisor to continue processing jobs'; /** * Execute the console command. * * @param \Laravel\Horizon\Contracts\SupervisorRepository $supervisors * @return void */ public function handle(SupervisorRepository $supervisors) { $processId = optional(collect($supervisors->all())->first(function ($supervisor) { return Str::startsWith($supervisor->name, MasterSupervisor::basename()) && Str::endsWith($supervisor->name, $this->argument('name')); }))->pid; if (is_null($processId)) { $this->components->error('Failed to find a supervisor with this name'); return 1; } $this->components->info("Sending CONT signal to process: {$processId}"); if (! posix_kill($processId, SIGCONT)) { $this->components->error("Failed to send CONT signal to process: {$processId} (".posix_strerror(posix_get_last_error()).')'); } } } PK ! ��� � Console/InstallCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Illuminate\Support\ServiceProvider; use Illuminate\Support\Str; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:install')] class InstallCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:install'; /** * The console command description. * * @var string */ protected $description = 'Install all of the Horizon resources'; /** * Execute the console command. * * @return void */ public function handle() { $this->components->info('Installing Horizon resources.'); collect([ 'Service Provider' => fn () => $this->callSilent('vendor:publish', ['--tag' => 'horizon-provider']) == 0, 'Configuration' => fn () => $this->callSilent('vendor:publish', ['--tag' => 'horizon-config']) == 0, ])->each(fn ($task, $description) => $this->components->task($description, $task)); $this->registerHorizonServiceProvider(); $this->components->info('Horizon scaffolding installed successfully.'); } /** * Register the Horizon service provider in the application configuration file. * * @return void */ protected function registerHorizonServiceProvider() { $namespace = Str::replaceLast('\\', '', $this->laravel->getNamespace()); if (file_exists($this->laravel->bootstrapPath('providers.php'))) { ServiceProvider::addProviderToBootstrapFile("{$namespace}\\Providers\\HorizonServiceProvider"); } else { $appConfig = file_get_contents(config_path('app.php')); if (Str::contains($appConfig, $namespace.'\\Providers\\HorizonServiceProvider::class')) { return; } file_put_contents(config_path('app.php'), str_replace( "{$namespace}\\Providers\EventServiceProvider::class,".PHP_EOL, "{$namespace}\\Providers\EventServiceProvider::class,".PHP_EOL." {$namespace}\Providers\HorizonServiceProvider::class,".PHP_EOL, $appConfig )); } file_put_contents(app_path('Providers/HorizonServiceProvider.php'), str_replace( "namespace App\Providers;", "namespace {$namespace}\Providers;", file_get_contents(app_path('Providers/HorizonServiceProvider.php')) )); } } PK ! �T}�� � Console/StatusCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:status')] class StatusCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:status'; /** * The console command description. * * @var string */ protected $description = 'Get the current status of Horizon'; /** * Execute the console command. * * @param \Laravel\Horizon\Contracts\MasterSupervisorRepository $masterSupervisorRepository * @return int */ public function handle(MasterSupervisorRepository $masterSupervisorRepository) { if (! $masters = $masterSupervisorRepository->all()) { $this->components->error('Horizon is inactive.'); return 2; } if (collect($masters)->contains(function ($master) { return $master->status === 'paused'; })) { $this->components->warn('Horizon is paused.'); return 1; } $this->components->info('Horizon is running.'); return 0; } } PK ! ��6�0 0 Console/SnapshotCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Laravel\Horizon\Contracts\MetricsRepository; use Laravel\Horizon\Lock; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:snapshot')] class SnapshotCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:snapshot'; /** * The console command description. * * @var string */ protected $description = 'Store a snapshot of the queue metrics'; /** * Execute the console command. * * @param \Laravel\Horizon\Lock $lock * @param \Laravel\Horizon\Contracts\MetricsRepository $metrics * @return void */ public function handle(Lock $lock, MetricsRepository $metrics) { if ($lock->get('metrics:snapshot', config('horizon.metrics.snapshot_lock', 300) - 30)) { $metrics->snapshot(); $this->components->info('Metrics snapshot stored successfully.'); } } } PK ! (�E Console/PauseCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Illuminate\Support\Arr; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\MasterSupervisor; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:pause')] class PauseCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:pause'; /** * The console command description. * * @var string */ protected $description = 'Pause the master supervisor'; /** * Execute the console command. * * @param \Laravel\Horizon\Contracts\MasterSupervisorRepository $masters * @return void */ public function handle(MasterSupervisorRepository $masters) { $masters = collect($masters->all())->filter(function ($master) { return Str::startsWith($master->name, MasterSupervisor::basename()); })->all(); collect(Arr::pluck($masters, 'pid')) ->whenNotEmpty(fn () => $this->components->info('Sending USR2 signal to processes.')) ->whenEmpty(fn () => $this->components->info('No processes to pause.')) ->each(function ($processId) { $result = true; $this->components->task("Process: $processId", function () use ($processId, &$result) { return $result = posix_kill($processId, SIGUSR2); }); if (! $result) { $this->components->error("Failed to kill process: {$processId} (".posix_strerror(posix_get_last_error()).')'); } })->whenNotEmpty(fn () => $this->output->writeln('')); } } PK ! 4�M&� � Console/ListCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:list')] class ListCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:list'; /** * The console command description. * * @var string */ protected $description = 'List all of the deployed machines'; /** * Execute the console command. * * @param \Laravel\Horizon\Contracts\MasterSupervisorRepository $masters * @return void */ public function handle(MasterSupervisorRepository $masters) { $masters = $masters->all(); if (empty($masters)) { return $this->components->info('No machines are running.'); } $this->output->writeln(''); $this->table([ 'Name', 'PID', 'Supervisors', 'Status', ], collect($masters)->map(function ($master) { return [ $master->name, $master->pid, $master->supervisors ? collect($master->supervisors)->map(function ($supervisor) { return explode(':', $supervisor, 2)[1]; })->implode(', ') : 'None', $master->status, ]; })->all()); $this->output->writeln(''); } } PK ! �o�-� � Console/HorizonCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\MasterSupervisor; use Laravel\Horizon\ProvisioningPlan; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon')] class HorizonCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon {--environment= : The environment name}'; /** * The console command description. * * @var string */ protected $description = 'Start a master supervisor in the foreground'; /** * Execute the console command. * * @param \Laravel\Horizon\Contracts\MasterSupervisorRepository $masters * @return void */ public function handle(MasterSupervisorRepository $masters) { if ($masters->find(MasterSupervisor::name())) { return $this->components->warn('A master supervisor is already running on this machine.'); } $environment = $this->option('environment') ?? config('horizon.env') ?? config('app.env'); $master = (new MasterSupervisor($environment))->handleOutputUsing(function ($type, $line) { $this->output->write($line); }); ProvisioningPlan::get(MasterSupervisor::name())->deploy($environment); $this->components->info('Horizon started successfully.'); pcntl_async_signals(true); pcntl_signal(SIGINT, function () use ($master) { $this->output->writeln(''); $this->components->info('Shutting down.'); return $master->terminate(); }); $master->monitor(); } } PK ! ��Oo o Console/ClearMetricsCommand.phpnu ȯ�� <?php namespace Laravel\Horizon\Console; use Illuminate\Console\Command; use Laravel\Horizon\Contracts\MetricsRepository; use Symfony\Component\Console\Attribute\AsCommand; #[AsCommand(name: 'horizon:clear-metrics')] class ClearMetricsCommand extends Command { /** * The name and signature of the console command. * * @var string */ protected $signature = 'horizon:clear-metrics'; /** * The console command description. * * @var string */ protected $description = 'Delete metrics for all jobs and queues'; /** * Execute the console command. * * @param \Laravel\Horizon\Contracts\MetricsRepository $metrics * @return void */ public function handle(MetricsRepository $metrics) { $metrics->clear(); $this->components->info('Metrics cleared successfully.'); } } PK ! �wx�6 6 Jobs/StopMonitoringTag.phpnu ȯ�� <?php namespace Laravel\Horizon\Jobs; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Contracts\TagRepository; class StopMonitoringTag { /** * The tag to stop monitoring. * * @var string */ public $tag; /** * Create a new job instance. * * @param string $tag * @return void */ public function __construct($tag) { $this->tag = $tag; } /** * Execute the job. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @param \Laravel\Horizon\Contracts\TagRepository $tags * @return void */ public function handle(JobRepository $jobs, TagRepository $tags) { $tags->stopMonitoring($this->tag); $monitored = $tags->paginate($this->tag); while (count($monitored) > 0) { $jobs->deleteMonitored($monitored); $offset = array_keys($monitored)[count($monitored) - 1] + 1; $monitored = $tags->paginate($this->tag, $offset); } $tags->forget($this->tag); } } PK ! ���&� � Jobs/RetryFailedJob.phpnu ȯ�� <?php namespace Laravel\Horizon\Jobs; use Carbon\CarbonImmutable; use Illuminate\Contracts\Queue\Factory as Queue; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\JobRepository; class RetryFailedJob { /** * The job ID. * * @var string */ public $id; /** * Create a new job instance. * * @param string $id * @return void */ public function __construct($id) { $this->id = $id; } /** * Execute the job. * * @param \Illuminate\Contracts\Queue\Factory $queue * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @return void */ public function handle(Queue $queue, JobRepository $jobs) { if (is_null($job = $jobs->findFailed($this->id))) { return; } $queue->connection($job->connection)->pushRaw( $this->preparePayload($id = Str::uuid(), $job->payload), $job->queue ); $jobs->storeRetryReference($this->id, $id); } /** * Prepare the payload for queueing. * * @param string $id * @param string $payload * @return string */ protected function preparePayload($id, $payload) { $payload = json_decode($payload, true); return json_encode(array_merge($payload, [ 'id' => $id, 'uuid' => $id, 'attempts' => 0, 'retry_of' => $this->id, 'retryUntil' => $this->prepareNewTimeout($payload), ])); } /** * Prepare the timeout. * * @param array $payload * @return int|null */ protected function prepareNewTimeout($payload) { $retryUntil = $payload['retryUntil'] ?? $payload['timeoutAt'] ?? null; $pushedAt = $payload['pushedAt'] ?? microtime(true); return $retryUntil ? CarbonImmutable::now()->addSeconds(ceil($retryUntil - $pushedAt))->getTimestamp() : null; } } PK ! (� [ [ Jobs/MonitorTag.phpnu ȯ�� <?php namespace Laravel\Horizon\Jobs; use Laravel\Horizon\Contracts\TagRepository; class MonitorTag { /** * The tag to monitor. * * @var string */ public $tag; /** * Create a new job instance. * * @param string $tag * @return void */ public function __construct($tag) { $this->tag = $tag; } /** * Execute the job. * * @param \Laravel\Horizon\Contracts\TagRepository $tags * @return void */ public function handle(TagRepository $tags) { $tags->monitor($this->tag); } } PK ! ��Z:� � % HorizonApplicationServiceProvider.phpnu ȯ�� <?php namespace Laravel\Horizon; use Illuminate\Support\Facades\Gate; use Illuminate\Support\ServiceProvider; class HorizonApplicationServiceProvider extends ServiceProvider { /** * Bootstrap any application services. * * @return void */ public function boot() { $this->authorization(); } /** * Configure the Horizon authorization services. * * @return void */ protected function authorization() { $this->gate(); Horizon::auth(function ($request) { return Gate::check('viewHorizon', [$request->user()]) || app()->environment('local'); }); } /** * Register the Horizon gate. * * This gate determines who can access Horizon in non-local environments. * * @return void */ protected function gate() { Gate::define('viewHorizon', function ($user) { return in_array($user->email, [ // ]); }); } /** * Register any application services. * * @return void */ public function register() { // } } PK ! �]b"� � Connectors/RedisConnector.phpnu ȯ�� <?php namespace Laravel\Horizon\Connectors; use Illuminate\Queue\Connectors\RedisConnector as BaseConnector; use Illuminate\Support\Arr; use Laravel\Horizon\RedisQueue; class RedisConnector extends BaseConnector { /** * Establish a queue connection. * * @param array $config * @return \Laravel\Horizon\RedisQueue */ public function connect(array $config) { return new RedisQueue( $this->redis, $config['queue'], Arr::get($config, 'connection', $this->connection), Arr::get($config, 'retry_after', 60), Arr::get($config, 'block_for', null), Arr::get($config, 'after_commit', null) ); } } PK ! �uN�� � RedisQueue.phpnu ȯ�� <?php namespace Laravel\Horizon; use Illuminate\Contracts\Events\Dispatcher; use Illuminate\Queue\RedisQueue as BaseQueue; use Illuminate\Support\Str; use Laravel\Horizon\Events\JobDeleted; use Laravel\Horizon\Events\JobPushed; use Laravel\Horizon\Events\JobReleased; use Laravel\Horizon\Events\JobReserved; use Laravel\Horizon\Events\JobsMigrated; class RedisQueue extends BaseQueue { /** * The job that last pushed to queue via the "push" method. * * @var object|string */ protected $lastPushed; /** * Get the number of queue jobs that are ready to process. * * @param string|null $queue * @return int */ public function readyNow($queue = null) { return $this->getConnection()->llen($this->getQueue($queue)); } /** * Push a new job onto the queue. * * @param object|string $job * @param mixed $data * @param string|null $queue * @return mixed */ public function push($job, $data = '', $queue = null) { return $this->enqueueUsing( $job, $this->createPayload($job, $this->getQueue($queue), $data), $queue, null, function ($payload, $queue) use ($job) { $this->lastPushed = $job; return $this->pushRaw($payload, $queue); } ); } /** * Push a raw payload onto the queue. * * @param string $payload * @param string $queue * @param array $options * @return mixed */ public function pushRaw($payload, $queue = null, array $options = []) { $payload = (new JobPayload($payload))->prepare($this->lastPushed); parent::pushRaw($payload->value, $queue, $options); $this->event($this->getQueue($queue), new JobPushed($payload->value)); return $payload->id(); } /** * Create a payload string from the given job and data. * * @param string $job * @param string $queue * @param mixed $data * @return array */ protected function createPayloadArray($job, $queue, $data = '') { $payload = parent::createPayloadArray($job, $queue, $data); $payload['id'] = $payload['uuid']; return $payload; } /** * Push a new job onto the queue after a delay. * * @param \DateTimeInterface|\DateInterval|int $delay * @param string $job * @param mixed $data * @param string $queue * @return mixed */ public function later($delay, $job, $data = '', $queue = null) { $payload = (new JobPayload($this->createPayload($job, $queue, $data)))->prepare($job)->value; if (method_exists($this, 'enqueueUsing')) { return $this->enqueueUsing( $job, $payload, $queue, $delay, function ($payload, $queue, $delay) { return tap(parent::laterRaw($delay, $payload, $queue), function () use ($payload, $queue) { $this->event($this->getQueue($queue), new JobPushed($payload)); }); } ); } return tap(parent::laterRaw($delay, $payload, $queue), function () use ($payload, $queue) { $this->event($this->getQueue($queue), new JobPushed($payload)); }); } /** * Pop the next job off of the queue. * * @param string $queue * @return \Illuminate\Contracts\Queue\Job|null */ public function pop($queue = null) { return tap(parent::pop($queue), function ($result) use ($queue) { if ($result) { $this->event($this->getQueue($queue), new JobReserved($result->getReservedJob())); } }); } /** * Migrate the delayed jobs that are ready to the regular queue. * * @param string $from * @param string $to * @return void */ public function migrateExpiredJobs($from, $to) { return tap(parent::migrateExpiredJobs($from, $to), function ($jobs) use ($to) { $this->event($to, new JobsMigrated($jobs)); }); } /** * Delete a reserved job from the queue. * * @param string $queue * @param \Illuminate\Queue\Jobs\RedisJob $job * @return void */ public function deleteReserved($queue, $job) { parent::deleteReserved($queue, $job); $this->event($this->getQueue($queue), new JobDeleted($job, $job->getReservedJob())); } /** * Delete a reserved job from the reserved queue and release it. * * @param string $queue * @param \Illuminate\Queue\Jobs\RedisJob $job * @param int $delay * @return void */ public function deleteAndRelease($queue, $job, $delay) { parent::deleteAndRelease($queue, $job, $delay); $this->event($this->getQueue($queue), new JobReleased($job->getReservedJob())); } /** * Fire the given event if a dispatcher is bound. * * @param string $queue * @param mixed $event * @return void */ protected function event($queue, $event) { if ($this->container && $this->container->bound(Dispatcher::class)) { $queue = Str::replaceFirst('queues:', '', $queue); $this->container->make(Dispatcher::class)->dispatch( $event->connection($this->getConnectionName())->queue($queue) ); } } } PK ! ;� b b ProcessPool.phpnu ȯ�� <?php namespace Laravel\Horizon; use Carbon\CarbonImmutable; use Closure; use Countable; use Symfony\Component\Process\Process; class ProcessPool implements Countable { /** * All of the active processes. * * @var array */ public $processes = []; /** * The processes that are terminating. * * @var array */ public $terminatingProcesses = []; /** * Indicates if the process pool is currently running. * * @var array */ public $working = true; /** * The supervisor options for the process pool. * * @var SupervisorOptions */ public $options; /** * The output handler. * * @var \Closure|null */ public $output; /** * Create a new process pool instance. * * @param \Laravel\Horizon\SupervisorOptions $options * @param \Closure|null $output * @return void */ public function __construct(SupervisorOptions $options, Closure $output = null) { $this->options = $options; $this->output = $output ?: function () { // }; } /** * Scale the process count. * * @param int $processes * @return void */ public function scale($processes) { $processes = max(0, (int) $processes); if ($processes === count($this->processes)) { return; } if ($processes > count($this->processes)) { $this->scaleUp($processes); } else { $this->scaleDown($processes); } } /** * Scale up to the given number of processes. * * @param int $processes * @return void */ protected function scaleUp($processes) { $difference = $processes - count($this->processes); for ($i = 0; $i < $difference; $i++) { $this->start(); } } /** * Scale down to the given number of processes. * * @param int $processes * @return void */ protected function scaleDown($processes) { $difference = count($this->processes) - $processes; // Here we will slice off the correct number of processes that we need to terminate // and remove them from the active process array. We'll be adding them the array // of terminating processes where they'll run until they are fully terminated. $terminatingProcesses = array_slice( $this->processes, 0, $difference ); collect($terminatingProcesses)->each(function ($process) { $this->markForTermination($process); })->all(); $this->removeProcesses($difference); // Finally we will call the terminate method on each of the processes that need get // terminated so they can start terminating. Terminating is a graceful operation // so any jobs they are already running will finish running before these quit. collect($this->terminatingProcesses) ->each(function ($process) { $process['process']->terminate(); }); } /** * Mark the given worker process for termination. * * @param \Laravel\Horizon\WorkerProcess $process * @return void */ public function markForTermination(WorkerProcess $process) { $this->terminatingProcesses[] = [ 'process' => $process, 'terminatedAt' => CarbonImmutable::now(), ]; } /** * Remove the given number of processes from the process array. * * @param int $count * @return void */ protected function removeProcesses($count) { array_splice($this->processes, 0, $count); $this->processes = array_values($this->processes); } /** * Add a new worker process to the pool. * * @return $this */ protected function start() { $this->processes[] = $this->createProcess()->handleOutputUsing(function ($type, $line) { call_user_func($this->output, $type, $line); }); return $this; } /** * Create a new process instance. * * @return \Laravel\Horizon\WorkerProcess */ protected function createProcess() { $class = config('horizon.fast_termination') ? BackgroundProcess::class : Process::class; return new WorkerProcess($class::fromShellCommandline( $this->options->toWorkerCommand(), $this->options->directory )->setTimeout(null)->disableOutput()); } /** * Evaluate the current state of all of the processes. * * @return void */ public function monitor() { $this->processes()->each->monitor(); } /** * Terminate all current workers and start fresh ones. * * @return void */ public function restart() { $count = count($this->processes); $this->scale(0); $this->scale($count); } /** * Pause all of the worker processes. * * @return void */ public function pause() { $this->working = false; collect($this->processes)->each->pause(); } /** * Instruct all of the worker processes to continue working. * * @return void */ public function continue() { $this->working = true; collect($this->processes)->each->continue(); } /** * Get the processes that are still terminating. * * @return \Illuminate\Support\Collection */ public function terminatingProcesses() { $this->pruneTerminatingProcesses(); return collect($this->terminatingProcesses); } /** * Remove any non-running processes from the terminating process list. * * @return void */ public function pruneTerminatingProcesses() { $this->stopTerminatingProcessesThatAreHanging(); $this->terminatingProcesses = collect( $this->terminatingProcesses )->filter(function ($process) { return $process['process']->isRunning(); })->all(); } /** * Stop any terminating processes that are hanging too long. * * @return void */ protected function stopTerminatingProcessesThatAreHanging() { foreach ($this->terminatingProcesses as $process) { $timeout = $this->options->timeout; if ($process['terminatedAt']->addSeconds((int) $timeout)->lte(CarbonImmutable::now())) { $process['process']->stop(); } } } /** * Get all of the current processes as a collection. * * @return \Illuminate\Support\Collection */ public function processes() { return collect($this->processes); } /** * Get all of the current running processes as a collection. * * @return \Illuminate\Support\Collection */ public function runningProcesses() { $terminatingProcesses = $this->terminatingProcesses()->map(function ($process) { return $process['process']; }); return collect($this->processes)->concat($terminatingProcesses)->filter(function ($process) { return $process->process->isRunning(); }); } /** * Get the total active process count, including processes pending termination. * * @return int */ public function totalProcessCount() { return count($this->processes()) + count($this->terminatingProcesses); } /** * The name of the queue(s) being worked by the pool. * * @return string */ public function queue() { return $this->options->queue; } /** * Count the total number of processes in the pool. * * @return int */ public function count(): int { return count($this->processes); } } PK ! =���Y Y & SupervisorCommands/ContinueWorking.phpnu ȯ�� <?php namespace Laravel\Horizon\SupervisorCommands; use Laravel\Horizon\Contracts\Pausable; class ContinueWorking { /** * Process the command. * * @param \Laravel\Horizon\Contracts\Pausable $pausable * @return void */ public function process(Pausable $pausable) { $pausable->continue(); } } PK ! ��w� � SupervisorCommands/Scale.phpnu ȯ�� <?php namespace Laravel\Horizon\SupervisorCommands; use Laravel\Horizon\Supervisor; class Scale { /** * Process the command. * * @param \Laravel\Horizon\Supervisor $supervisor * @param array $options * @return void */ public function process(Supervisor $supervisor, array $options) { $supervisor->scale($options['scale']); } } PK ! BN�Ԧ � SupervisorCommands/Terminate.phpnu ȯ�� <?php namespace Laravel\Horizon\SupervisorCommands; use Laravel\Horizon\Contracts\Terminable; class Terminate { /** * Process the command. * * @param \Laravel\Horizon\Contracts\Terminable $terminable * @param array $options * @return void */ public function process(Terminable $terminable, array $options) { $terminable->terminate($options['status'] ?? 0); } } PK ! ��OD SupervisorCommands/Balance.phpnu ȯ�� <?php namespace Laravel\Horizon\SupervisorCommands; use Laravel\Horizon\Supervisor; class Balance { /** * Process the command. * * @param \Laravel\Horizon\Supervisor $supervisor * @param array $options * @return void */ public function process(Supervisor $supervisor, array $options) { $supervisor->balance($options); } } PK ! ���<b b SupervisorCommands/Restart.phpnu ȯ�� <?php namespace Laravel\Horizon\SupervisorCommands; use Laravel\Horizon\Contracts\Restartable; class Restart { /** * Process the command. * * @param \Laravel\Horizon\Contracts\Restartable $restartable * @return void */ public function process(Restartable $restartable) { $restartable->restart(); } } PK ! `���L L SupervisorCommands/Pause.phpnu ȯ�� <?php namespace Laravel\Horizon\SupervisorCommands; use Laravel\Horizon\Contracts\Pausable; class Pause { /** * Process the command. * * @param \Laravel\Horizon\Contracts\Pausable $pausable * @return void */ public function process(Pausable $pausable) { $pausable->pause(); } } PK ! ���& & PhpBinary.phpnu ȯ�� <?php namespace Laravel\Horizon; class PhpBinary { /** * Get the path to the PHP executable. * * @return string */ public static function path() { $escape = '\\' === DIRECTORY_SEPARATOR ? '"' : '\''; return $escape.PHP_BINARY.$escape; } } PK ! Tp p Tags.phpnu ȯ�� <?php namespace Laravel\Horizon; use Illuminate\Broadcasting\BroadcastEvent; use Illuminate\Database\Eloquent\Collection as EloquentCollection; use Illuminate\Database\Eloquent\Model; use Illuminate\Events\CallQueuedListener; use Illuminate\Mail\SendQueuedMailable; use Illuminate\Notifications\SendQueuedNotifications; use ReflectionClass; use ReflectionProperty; use stdClass; class Tags { /** * The event that was last handled. * * @var object|null */ protected static $event; /** * Determine the tags for the given job. * * @param mixed $job * @return array */ public static function for($job) { if ($tags = static::extractExplicitTags($job)) { return $tags; } return static::modelsFor(static::targetsFor($job))->map(function ($model) { return get_class($model).':'.$model->getKey(); })->all(); } /** * Extract tags from job object. * * @param mixed $job * @return array */ public static function extractExplicitTags($job) { return $job instanceof CallQueuedListener ? static::tagsForListener($job) : static::explicitTags(static::targetsFor($job)); } /** * Determine tags for the given queued listener. * * @param mixed $job * @return array */ protected static function tagsForListener($job) { $event = static::extractEvent($job); static::setEvent($event); return collect( [static::extractListener($job), $event] )->map(function ($job) { return static::for($job); })->collapse()->unique()->tap(function () { static::flushEventState(); })->toArray(); } /** * Determine tags for the given job. * * @param array $jobs * @return array */ protected static function explicitTags(array $jobs) { return collect($jobs)->map(function ($job) { return method_exists($job, 'tags') ? $job->tags(static::$event) : []; })->collapse()->unique()->all(); } /** * Get the actual target for the given job. * * @param mixed $job * @return array */ public static function targetsFor($job) { return match (true) { $job instanceof BroadcastEvent => [$job->event], $job instanceof CallQueuedListener => [static::extractEvent($job)], $job instanceof SendQueuedMailable => [$job->mailable], $job instanceof SendQueuedNotifications => [$job->notification], default => [$job], }; } /** * Get the models from the given object. * * @param array $targets * @return \Illuminate\Support\Collection */ public static function modelsFor(array $targets) { $models = []; foreach ($targets as $target) { $models[] = collect( (new ReflectionClass($target))->getProperties() )->map(function ($property) use ($target) { $property->setAccessible(true); $value = static::getValue($property, $target); if ($value instanceof Model) { return [$value]; } elseif ($value instanceof EloquentCollection) { return $value->all(); } })->collapse()->filter()->all(); } return collect($models)->collapse()->unique(); } /** * Get the value of the given ReflectionProperty. * * @param \ReflectionProperty $property * @param mixed $target */ protected static function getValue(ReflectionProperty $property, $target) { if (method_exists($property, 'isInitialized') && ! $property->isInitialized($target)) { return; } return $property->getValue($target); } /** * Extract the listener from a queued job. * * @param mixed $job * @return mixed */ protected static function extractListener($job) { return (new ReflectionClass($job->class))->newInstanceWithoutConstructor(); } /** * Extract the event from a queued job. * * @param mixed $job * @return mixed */ protected static function extractEvent($job) { return isset($job->data[0]) && is_object($job->data[0]) ? $job->data[0] : new stdClass; } /** * Set the event currently being handled. * * @param object $event * @return void */ protected static function setEvent($event) { static::$event = $event; } /** * Flush the event currently being handled. * * @return void */ protected static function flushEventState() { static::$event = null; } } PK ! <Y�* * JobPayload.phpnu ȯ�� <?php namespace Laravel\Horizon; use ArrayAccess; use Illuminate\Broadcasting\BroadcastEvent; use Illuminate\Events\CallQueuedListener; use Illuminate\Mail\SendQueuedMailable; use Illuminate\Notifications\SendQueuedNotifications; use Illuminate\Support\Arr; use Laravel\Horizon\Contracts\Silenced; class JobPayload implements ArrayAccess { /** * The raw payload string. * * @var string */ public $value; /** * The decoded payload array. * * @var array */ public $decoded; /** * Create a new raw job payload instance. * * @param string $value * @return void */ public function __construct($value) { $this->value = $value; $this->decoded = json_decode($value, true); } /** * Get the job ID from the payload. * * @return string */ public function id() { return $this->decoded['uuid'] ?? $this->decoded['id']; } /** * Get the job tags from the payload. * * @return array */ public function tags() { return Arr::get($this->decoded, 'tags', []); } /** * Determine if the job is a retry of a previous job. * * @return bool */ public function isRetry() { return isset($this->decoded['retry_of']); } /** * Get the ID of the job this job is a retry of. * * @return string|null */ public function retryOf() { return $this->decoded['retry_of'] ?? null; } /** * Determine if the job has been silenced. * * @return bool */ public function isSilenced() { return $this->decoded['silenced'] ?? false; } /** * Prepare the payload for storage on the queue by adding tags, etc. * * @param mixed $job * @return $this */ public function prepare($job) { return $this->set([ 'type' => $this->determineType($job), 'tags' => $this->determineTags($job), 'silenced' => $this->shouldBeSilenced($job), 'pushedAt' => str_replace(',', '.', microtime(true)), ]); } /** * Get the "type" of job being queued. * * @param mixed $job * @return string */ protected function determineType($job) { return match (true) { $job instanceof BroadcastEvent => 'broadcast', $job instanceof CallQueuedListener => 'event', $job instanceof SendQueuedMailable => 'mail', $job instanceof SendQueuedNotifications => 'notification', default => 'job', }; } /** * Get the appropriate tags for the job. * * @param mixed $job * @return array */ protected function determineTags($job) { return array_merge( $this->decoded['tags'] ?? [], ! $job || is_string($job) ? [] : Tags::for($job) ); } /** * Determine if the underlying job class should be silenced. * * @param mixed $job * @return bool */ protected function shouldBeSilenced($job) { if (! $job) { return false; } $underlyingJob = $this->underlyingJob($job); $jobClass = is_string($underlyingJob) ? $underlyingJob : get_class($underlyingJob); return in_array($jobClass, config('horizon.silenced', [])) || is_a($jobClass, Silenced::class, true); } /** * Get the underlying queued job. * * @param mixed $job * @return mixed */ protected function underlyingJob($job) { return match (true) { $job instanceof BroadcastEvent => $job->event, $job instanceof CallQueuedListener => $job->class, $job instanceof SendQueuedMailable => $job->mailable, $job instanceof SendQueuedNotifications => $job->notification, default => $job, }; } /** * Set the given key / value pairs on the payload. * * @param array $values * @return $this */ public function set(array $values) { $this->decoded = array_merge($this->decoded, $values); $this->value = json_encode($this->decoded); return $this; } /** * Get the "command name" for the job. * * @return string */ public function commandName() { return Arr::get($this->decoded, 'data.commandName'); } /** * Get the "display name" for the job. * * @return string */ public function displayName() { return Arr::get($this->decoded, 'displayName'); } /** * Determine if the given offset exists. * * @param string $offset * @return bool */ public function offsetExists($offset): bool { return array_key_exists($offset, $this->decoded); } /** * Get the value at the current offset. * * @param string $offset * @return mixed */ #[\ReturnTypeWillChange] public function offsetGet($offset) { return $this->decoded[$offset]; } /** * Set the value at the current offset. * * @param string $offset * @param mixed $value * @return void */ public function offsetSet($offset, $value): void { $this->decoded[$offset] = $value; } /** * Unset the value at the current offset. * * @param string $offset * @return void */ public function offsetUnset($offset): void { unset($this->decoded[$offset]); } } PK ! )�? ? ! Exceptions/ForbiddenException.phpnu ȯ�� <?php namespace Laravel\Horizon\Exceptions; use Symfony\Component\HttpKernel\Exception\HttpException; class ForbiddenException extends HttpException { /** * Create a new exception instance. * * @return static */ public static function make() { return new static(403); } } PK ! G�]� � ) Http/Controllers/MonitoringController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Illuminate\Http\Request; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Contracts\TagRepository; use Laravel\Horizon\Jobs\MonitorTag; use Laravel\Horizon\Jobs\StopMonitoringTag; class MonitoringController extends Controller { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * The tag repository implementation. * * @var \Laravel\Horizon\Contracts\TagRepository */ public $tags; /** * Create a new controller instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @param \Laravel\Horizon\Contracts\TagRepository $tags * @return void */ public function __construct(JobRepository $jobs, TagRepository $tags) { parent::__construct(); $this->jobs = $jobs; $this->tags = $tags; } /** * Get all of the monitored tags and their job counts. * * @return \Illuminate\Support\Collection */ public function index() { return collect($this->tags->monitoring())->map(function ($tag) { return [ 'tag' => $tag, 'count' => $this->tags->count($tag) + $this->tags->count('failed:'.$tag), ]; })->sortBy('tag')->values(); } /** * Paginate the jobs for a given tag. * * @param \Illuminate\Http\Request $request * @return array */ public function paginate(Request $request) { $tag = $request->query('tag'); $jobIds = $this->tags->paginate( $tag, $startingAt = $request->query('starting_at', 0), $request->query('limit', 25) ); return [ 'jobs' => $this->getJobs($jobIds, $startingAt), 'total' => $this->tags->count($tag), ]; } /** * Get the jobs for the given IDs. * * @param array $jobIds * @param int $startingAt * @return \Illuminate\Support\Collection */ protected function getJobs($jobIds, $startingAt = 0) { return $this->jobs->getJobs($jobIds, $startingAt)->map(function ($job) { $job->payload = json_decode($job->payload); return $job; })->values(); } /** * Start monitoring the given tag. * * @param \Illuminate\Http\Request $request * @return void */ public function store(Request $request) { dispatch(new MonitorTag($request->tag)); } /** * Stop monitoring the given tag. * * @param string $tag * @return void */ public function destroy($tag) { dispatch(new StopMonitoringTag($tag)); } } PK ! �{� � + Http/Controllers/QueueMetricsController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Laravel\Horizon\Contracts\MetricsRepository; class QueueMetricsController extends Controller { /** * The metrics repository implementation. * * @var \Laravel\Horizon\Contracts\MetricsRepository */ public $metrics; /** * Create a new controller instance. * * @param \Laravel\Horizon\Contracts\MetricsRepository $metrics * @return void */ public function __construct(MetricsRepository $metrics) { parent::__construct(); $this->metrics = $metrics; } /** * Get all of the measured queues. * * @return array */ public function index() { return $this->metrics->measuredQueues(); } /** * Get metrics for a given queue. * * @param string $id * @return \Illuminate\Support\Collection */ public function show($id) { return collect($this->metrics->snapshotsForQueue($id))->map(function ($record) { $record->runtime = round($record->runtime / 1000, 3); $record->throughput = (int) $record->throughput; return $record; }); } } PK ! O#�! ! * Http/Controllers/PendingJobsController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Illuminate\Http\Request; use Laravel\Horizon\Contracts\JobRepository; class PendingJobsController extends Controller { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * Create a new controller instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @return void */ public function __construct(JobRepository $jobs) { parent::__construct(); $this->jobs = $jobs; } /** * Get all of the pending jobs. * * @param \Illuminate\Http\Request $request * @return array */ public function index(Request $request) { $jobs = $this->jobs->getPending($request->query('starting_at', -1))->map(function ($job) { $job->payload = json_decode($job->payload); return $job; })->values(); return [ 'jobs' => $jobs, 'total' => $this->jobs->countPending(), ]; } /** * Decode the given job. * * @param object $job * @return object */ protected function decode($job) { $job->payload = json_decode($job->payload); return $job; } } PK ! ͏�"% % - Http/Controllers/DashboardStatsController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\Contracts\MetricsRepository; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\WaitTimeCalculator; class DashboardStatsController extends Controller { /** * Get the key performance stats for the dashboard. * * @return array */ public function index() { return [ 'failedJobs' => app(JobRepository::class)->countRecentlyFailed(), 'jobsPerMinute' => app(MetricsRepository::class)->jobsProcessedPerMinute(), 'pausedMasters' => $this->totalPausedMasters(), 'periods' => [ 'failedJobs' => config('horizon.trim.recent_failed', config('horizon.trim.failed')), 'recentJobs' => config('horizon.trim.recent'), ], 'processes' => $this->totalProcessCount(), 'queueWithMaxRuntime' => app(MetricsRepository::class)->queueWithMaximumRuntime(), 'queueWithMaxThroughput' => app(MetricsRepository::class)->queueWithMaximumThroughput(), 'recentJobs' => app(JobRepository::class)->countRecent(), 'status' => $this->currentStatus(), 'wait' => collect(app(WaitTimeCalculator::class)->calculate())->take(1), ]; } /** * Get the total process count across all supervisors. * * @return int */ protected function totalProcessCount() { $supervisors = app(SupervisorRepository::class)->all(); return collect($supervisors)->reduce(function ($carry, $supervisor) { return $carry + collect($supervisor->processes)->sum(); }, 0); } /** * Get the current status of Horizon. * * @return string */ protected function currentStatus() { if (! $masters = app(MasterSupervisorRepository::class)->all()) { return 'inactive'; } return collect($masters)->every(function ($master) { return $master->status === 'paused'; }) ? 'paused' : 'running'; } /** * Get the number of master supervisors that are currently paused. * * @return int */ protected function totalPausedMasters() { if (! $masters = app(MasterSupervisorRepository::class)->all()) { return 0; } return collect($masters)->filter(function ($master) { return $master->status === 'paused'; })->count(); } } PK ! k��� � & Http/Controllers/BatchesController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Illuminate\Bus\BatchRepository; use Illuminate\Database\QueryException; use Illuminate\Http\Request; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Jobs\RetryFailedJob; class BatchesController extends Controller { /** * The job repository implementation. * * @var \Illuminate\Bus\BatchRepository */ public $batches; /** * Create a new controller instance. * * @param \Illuminate\Bus\BatchRepository $batches * @return void */ public function __construct(BatchRepository $batches) { parent::__construct(); $this->batches = $batches; } /** * Get all of the batches. * * @param \Illuminate\Http\Request $request * @return array */ public function index(Request $request) { try { $batches = $this->batches->get(50, $request->query('before_id') ?: null); } catch (QueryException $e) { $batches = []; } return [ 'batches' => $batches, ]; } /** * Get the details of a batch by ID. * * @param string $id * @return array */ public function show($id) { $batch = $this->batches->find($id); if ($batch) { $failedJobs = app(JobRepository::class) ->getJobs($batch->failedJobIds); } return [ 'batch' => $batch, 'failedJobs' => $failedJobs ?? null, ]; } /** * Retry the given batch. * * @param string $id * @return void */ public function retry($id) { $batch = $this->batches->find($id); if ($batch) { app(JobRepository::class) ->getJobs($batch->failedJobIds) ->reject(function ($job) { $payload = json_decode($job->payload); return isset($payload->retry_of); })->each(function ($job) { dispatch(new RetryFailedJob($job->id)); }); } } } PK ! B��� � ' Http/Controllers/WorkloadController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Laravel\Horizon\Contracts\WorkloadRepository; class WorkloadController extends Controller { /** * Get the current queue workload for the application. * * @param \Laravel\Horizon\Contracts\WorkloadRepository $workload * @return array */ public function index(WorkloadRepository $workload) { return collect($workload->get())->sortBy('name')->values()->toArray(); } } PK ! ��n� � ) Http/Controllers/JobMetricsController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Laravel\Horizon\Contracts\MetricsRepository; class JobMetricsController extends Controller { /** * The metrics repository implementation. * * @var \Laravel\Horizon\Contracts\MetricsRepository */ public $metrics; /** * Create a new controller instance. * * @param \Laravel\Horizon\Contracts\MetricsRepository $metrics * @return void */ public function __construct(MetricsRepository $metrics) { parent::__construct(); $this->metrics = $metrics; } /** * Get all of the measured jobs. * * @return array */ public function index() { return $this->metrics->measuredJobs(); } /** * Get metrics for a given job. * * @param string $id * @return \Illuminate\Support\Collection */ public function show($id) { return collect($this->metrics->snapshotsForJob($id))->map(function ($record) { $record->runtime = round($record->runtime / 1000, 3); $record->throughput = (int) $record->throughput; return $record; }); } } PK ! �Mv�0 0 # Http/Controllers/JobsController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Laravel\Horizon\Contracts\JobRepository; class JobsController extends Controller { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * Create a new controller instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @return void */ public function __construct(JobRepository $jobs) { parent::__construct(); $this->jobs = $jobs; } /** * Get the details of a recent job by ID. * * @param string $id * @return array */ public function show($id) { return (array) $this->jobs->getJobs([$id])->map(function ($job) { return $this->decode($job); })->first(); } /** * Decode the given job. * * @param object $job * @return object */ protected function decode($job) { $job->payload = json_decode($job->payload); return $job; } } PK ! ���h� � / Http/Controllers/MasterSupervisorController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\ProvisioningPlan; class MasterSupervisorController extends Controller { /** * Get all of the master supervisors and their underlying supervisors. * * @param \Laravel\Horizon\Contracts\MasterSupervisorRepository $masters * @param \Laravel\Horizon\Contracts\SupervisorRepository $supervisors * @return \Illuminate\Support\Collection */ public function index(MasterSupervisorRepository $masters, SupervisorRepository $supervisors) { $masters = collect($masters->all())->keyBy('name')->sortBy('name'); $supervisors = collect($supervisors->all())->sortBy('name')->groupBy('master'); return $masters->each(function ($master, $name) use ($supervisors) { $master->supervisors = ($supervisors->get($name) ?? collect()) ->merge( collect(ProvisioningPlan::get($name)->plan[$master->environment ?? config('horizon.env') ?? config('app.env')] ?? []) ->map(function ($value, $key) use ($name) { return (object) [ 'name' => $name.':'.$key, 'master' => $name, 'status' => 'inactive', 'processes' => [], 'options' => [ 'queue' => array_key_exists('queue', $value) && is_array($value['queue']) ? implode(',', $value['queue']) : ($value['queue'] ?? ''), 'balance' => $value['balance'] ?? null, ], ]; }) ) ->unique('name') ->values(); }); } } PK ! $��B B $ Http/Controllers/RetryController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Laravel\Horizon\Jobs\RetryFailedJob; class RetryController extends Controller { /** * Retry a failed job. * * @param string $id * @return void */ public function store($id) { dispatch(new RetryFailedJob($id)); } } PK ! � 5� � # Http/Controllers/HomeController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Illuminate\Support\Facades\App; class HomeController extends Controller { /** * Single page application catch-all route. * * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View */ public function index() { return view('horizon::layout', [ 'isDownForMaintenance' => App::isDownForMaintenance(), ]); } } PK ! `�Q�z z Http/Controllers/Controller.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Illuminate\Routing\Controller as BaseController; use Laravel\Horizon\Http\Middleware\Authenticate; class Controller extends BaseController { /** * Create a new controller instance. * * @return void */ public function __construct() { $this->middleware(Authenticate::class); } } PK ! k�.) ) , Http/Controllers/CompletedJobsController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Illuminate\Http\Request; use Laravel\Horizon\Contracts\JobRepository; class CompletedJobsController extends Controller { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * Create a new controller instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @return void */ public function __construct(JobRepository $jobs) { parent::__construct(); $this->jobs = $jobs; } /** * Get all of the completed jobs. * * @param \Illuminate\Http\Request $request * @return array */ public function index(Request $request) { $jobs = $this->jobs->getCompleted($request->query('starting_at', -1))->map(function ($job) { $job->payload = json_decode($job->payload); return $job; })->values(); return [ 'jobs' => $jobs, 'total' => $this->jobs->countCompleted(), ]; } /** * Decode the given job. * * @param object $job * @return object */ protected function decode($job) { $job->payload = json_decode($job->payload); return $job; } } PK ! _mL� � ) Http/Controllers/FailedJobsController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Illuminate\Http\Request; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Contracts\TagRepository; class FailedJobsController extends Controller { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * The tag repository implementation. * * @var \Laravel\Horizon\Contracts\TagRepository */ public $tags; /** * Create a new controller instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @param \Laravel\Horizon\Contracts\TagRepository $tags * @return void */ public function __construct(JobRepository $jobs, TagRepository $tags) { parent::__construct(); $this->jobs = $jobs; $this->tags = $tags; } /** * Get all of the failed jobs. * * @param \Illuminate\Http\Request $request * @return array */ public function index(Request $request) { $jobs = ! $request->query('tag') ? $this->paginate($request) : $this->paginateByTag($request, $request->query('tag')); $total = $request->query('tag') ? $this->tags->count('failed:'.$request->query('tag')) : $this->jobs->countFailed(); return [ 'jobs' => $jobs, 'total' => $total, ]; } /** * Paginate the failed jobs for the request. * * @param \Illuminate\Http\Request $request * @return \Illuminate\Support\Collection */ protected function paginate(Request $request) { return $this->jobs->getFailed($request->query('starting_at') ?: -1)->map(function ($job) { return $this->decode($job); }); } /** * Paginate the failed jobs for the request and tag. * * @param \Illuminate\Http\Request $request * @param string $tag * @return \Illuminate\Support\Collection */ protected function paginateByTag(Request $request, $tag) { $jobIds = $this->tags->paginate( 'failed:'.$tag, ($request->query('starting_at') ?: -1) + 1, 50 ); $startingAt = $request->query('starting_at', 0); return $this->jobs->getJobs($jobIds, $startingAt)->map(function ($job) { return $this->decode($job); }); } /** * Get a failed job instance. * * @param string $id * @return mixed */ public function show($id) { return (array) $this->jobs->getJobs([$id])->map(function ($job) { return $this->decode($job); })->first(); } /** * Decode the given job. * * @param object $job * @return object */ protected function decode($job) { $job->payload = json_decode($job->payload); $job->exception = mb_convert_encoding($job->exception, 'UTF-8'); $job->context = json_decode($job->context ?? ''); $job->retried_by = collect(! is_null($job->retried_by) ? json_decode($job->retried_by) : []) ->sortByDesc('retried_at')->values(); return $job; } } PK ! �P��% % + Http/Controllers/SilencedJobsController.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Controllers; use Illuminate\Http\Request; use Laravel\Horizon\Contracts\JobRepository; class SilencedJobsController extends Controller { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * Create a new controller instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @return void */ public function __construct(JobRepository $jobs) { parent::__construct(); $this->jobs = $jobs; } /** * Get all of the silenced jobs. * * @param \Illuminate\Http\Request $request * @return array */ public function index(Request $request) { $jobs = $this->jobs->getSilenced($request->query('starting_at', -1))->map(function ($job) { $job->payload = json_decode($job->payload); return $job; })->values(); return [ 'jobs' => $jobs, 'total' => $this->jobs->countSilenced(), ]; } /** * Decode the given job. * * @param object $job * @return object */ protected function decode($job) { $job->payload = json_decode($job->payload); return $job; } } PK ! 5( Http/Middleware/Authenticate.phpnu ȯ�� <?php namespace Laravel\Horizon\Http\Middleware; use Laravel\Horizon\Exceptions\ForbiddenException; use Laravel\Horizon\Horizon; class Authenticate { /** * Handle the incoming request. * * @param \Illuminate\Http\Request $request * @param \Closure $next * @return \Illuminate\Http\Response|null */ public function handle($request, $next) { if (! Horizon::check($request)) { throw ForbiddenException::make(); } return $next($request); } } PK ! L�d/ / RedisHorizonCommandQueue.phpnu ȯ�� <?php namespace Laravel\Horizon; use Illuminate\Contracts\Redis\Factory as RedisFactory; use Laravel\Horizon\Contracts\HorizonCommandQueue; class RedisHorizonCommandQueue implements HorizonCommandQueue { /** * The Redis connection instance. * * @var \Illuminate\Contracts\Redis\Factory */ public $redis; /** * Create a new command queue instance. * * @param \Illuminate\Contracts\Redis\Factory $redis * @return void */ public function __construct(RedisFactory $redis) { $this->redis = $redis; } /** * Push a command onto a given queue. * * @param string $name * @param string $command * @param array $options * @return void */ public function push($name, $command, array $options = []) { $this->connection()->rpush('commands:'.$name, json_encode([ 'command' => $command, 'options' => $options, ])); } /** * Get the pending commands for a given queue name. * * @param string $name * @return array */ public function pending($name) { $length = $this->connection()->llen('commands:'.$name); if ($length < 1) { return []; } $results = $this->connection()->pipeline(function ($pipe) use ($name, $length) { $pipe->lrange('commands:'.$name, 0, $length - 1); $pipe->ltrim('commands:'.$name, $length, -1); }); return collect($results[0])->map(function ($result) { return (object) json_decode($result, true); })->all(); } /** * Flush the command queue for a given queue name. * * @param string $name * @return void */ public function flush($name) { $this->connection()->del('commands:'.$name); } /** * Get the Redis connection instance. * * @return \Illuminate\Redis\Connections\Connection */ protected function connection() { return $this->redis->connection('horizon'); } } PK ! �1��Y Y QueueCommandString.phpnu ȯ�� <?php namespace Laravel\Horizon; class QueueCommandString { /** * Get the additional option string for the worker command. * * @param \Laravel\Horizon\SupervisorOptions $options * @return string */ public static function toWorkerOptionsString(SupervisorOptions $options) { return sprintf('--name=%s --supervisor=%s %s', $options->workersName, $options->name, static::toOptionsString($options) ); } /** * Get the additional option string for the supervisor command. * * @param \Laravel\Horizon\SupervisorOptions $options * @return string */ public static function toSupervisorOptionsString(SupervisorOptions $options) { return sprintf('--workers-name=%s --balance=%s --max-processes=%s --min-processes=%s --nice=%s --balance-cooldown=%s --balance-max-shift=%s --parent-id=%s --auto-scaling-strategy=%s %s', $options->workersName, $options->balance, $options->maxProcesses, $options->minProcesses, $options->nice, $options->balanceCooldown, $options->balanceMaxShift, $options->parentId, $options->autoScalingStrategy, static::toOptionsString($options) ); } /** * Get the additional option string for the command. * * @param \Laravel\Horizon\SupervisorOptions $options * @param bool $paused * @return string */ public static function toOptionsString(SupervisorOptions $options, $paused = false) { $string = sprintf('--backoff=%s --max-time=%s --max-jobs=%s --memory=%s --queue="%s" --sleep=%s --timeout=%s --tries=%s --rest=%s', $options->backoff, $options->maxTime, $options->maxJobs, $options->memory, $options->queue, $options->sleep, $options->timeout, $options->maxTries, $options->rest ); if ($options->force) { $string .= ' --force'; } if ($paused) { $string .= ' --paused'; } return $string; } } PK ! h��\ / / Supervisor.phpnu ȯ�� <?php namespace Laravel\Horizon; use Carbon\CarbonImmutable; use Closure; use Exception; use Illuminate\Contracts\Cache\Factory as CacheFactory; use Illuminate\Contracts\Debug\ExceptionHandler; use Laravel\Horizon\Contracts\HorizonCommandQueue; use Laravel\Horizon\Contracts\Pausable; use Laravel\Horizon\Contracts\Restartable; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\Contracts\Terminable; use Laravel\Horizon\Events\SupervisorLooped; use Throwable; class Supervisor implements Pausable, Restartable, Terminable { use ListensForSignals; /** * The name of this supervisor instance. * * @return string */ public $name; /** * The SupervisorOptions that should be utilized. * * @var \Laravel\Horizon\SupervisorOptions */ public $options; /** * All of the process pools being managed. * * @var \Illuminate\Support\Collection */ public $processPools; /** * Indicates if the Supervisor processes are working. * * @var bool */ public $working = true; /** * The time at which auto-scaling last ran for this supervisor. * * @var \Carbon\CarbonImmutable */ public $lastAutoScaled; /** * The output handler. * * @var \Closure|null */ public $output; /** * Create a new supervisor instance. * * @param \Laravel\Horizon\SupervisorOptions $options * @return void */ public function __construct(SupervisorOptions $options) { $this->options = $options; $this->name = $options->name; $this->processPools = $this->createProcessPools(); $this->output = function () { // }; app(HorizonCommandQueue::class)->flush($this->name); } /** * Create the supervisor's process pools. * * @return \Illuminate\Support\Collection */ public function createProcessPools() { return $this->options->balancing() ? $this->createProcessPoolPerQueue() : $this->createSingleProcessPool(); } /** * Create a process pool for each queue. * * @return \Illuminate\Support\Collection */ protected function createProcessPoolPerQueue() { return collect(explode(',', $this->options->queue))->map(function ($queue) { return $this->createProcessPool($this->options->withQueue($queue)); }); } /** * Create a single process pool. * * @return \Illuminate\Support\Collection */ protected function createSingleProcessPool() { return collect([$this->createProcessPool($this->options)]); } /** * Create a new process pool with the given options. * * @param \Laravel\Horizon\SupervisorOptions $options * @return \Laravel\Horizon\ProcessPool */ protected function createProcessPool(SupervisorOptions $options) { return new ProcessPool($options, function ($type, $line) { $this->output($type, $line); }); } /** * Scale the process count. * * @param int $processes * @return void */ public function scale($processes) { $this->options->maxProcesses = max($this->options->maxProcesses, $processes, count($this->processPools) ); $this->balance($this->processPools->mapWithKeys(function ($pool) use ($processes) { return [$pool->queue() => floor($processes / count($this->processPools))]; })->all()); } /** * Balance the process pool at the given scales. * * @param array $balance * @return void */ public function balance(array $balance) { foreach ($balance as $queue => $scale) { $this->processPools->first(function ($pool) use ($queue) { return $pool->queue() === $queue; }, new class { public function __call($method, $arguments) { } })->scale($scale); } } /** * Terminate all current workers and start fresh ones. * * @return void */ public function restart() { $this->working = true; $this->processPools->each->restart(); } /** * Pause all of the worker processes. * * @return void */ public function pause() { $this->working = false; $this->processPools->each->pause(); } /** * Instruct all of the worker processes to continue working. * * @return void */ public function continue() { $this->working = true; $this->processPools->each->continue(); } /** * Terminate this supervisor process and all of its workers. * * @param int $status * @return void */ public function terminate($status = 0) { $this->working = false; // We will mark this supervisor as terminating so that any user interface can // correctly show the supervisor's status. Then, we will scale the process // pools down to zero workers to gracefully terminate them all out here. app(SupervisorRepository::class)->forget($this->name); $this->processPools->each(function ($pool) { $pool->processes()->each(function ($process) { $process->terminate(); }); }); if ($this->shouldWait()) { while ($this->processPools->map->runningProcesses()->collapse()->count()) { sleep(1); } } $this->exit($status); } /** * Check if the supervisor should wait for all its workers to terminate. * * @return bool */ protected function shouldWait() { return ! config('horizon.fast_termination') || app(CacheFactory::class)->get('horizon:terminate:wait'); } /** * Monitor the worker processes. * * @return void */ public function monitor() { $this->ensureNoDuplicateSupervisors(); $this->listenForSignals(); $this->persist(); while (true) { sleep(1); $this->loop(); } } /** * Ensure no other supervisors are running with the same name. * * @return void * * @throws \Exception */ public function ensureNoDuplicateSupervisors() { if (app(SupervisorRepository::class)->find($this->name) !== null) { throw new Exception("A supervisor with the name [{$this->name}] is already running."); } } /** * Perform a monitor loop. * * @return void */ public function loop() { try { $this->ensureParentIsRunning(); $this->processPendingSignals(); $this->processPendingCommands(); // If the supervisor is working, we will perform any needed scaling operations and // monitor all of these underlying worker processes to make sure they are still // processing queued jobs. If they have died, we will restart them each here. if ($this->working) { $this->autoScale(); $this->processPools->each->monitor(); } // Next, we'll persist the supervisor state to storage so that it can be read by a // user interface. This contains information on the specific options for it and // the current number of worker processes per queue for easy load monitoring. $this->persist(); event(new SupervisorLooped($this)); } catch (Throwable $e) { app(ExceptionHandler::class)->report($e); } } /** * Ensure the parent process is still running. * * @return void */ protected function ensureParentIsRunning() { if ($this->options->parentId > 1 && posix_getppid() <= 1) { $this->terminate(); } } /** * Handle any pending commands for the supervisor. * * @return void */ protected function processPendingCommands() { foreach (app(HorizonCommandQueue::class)->pending($this->name) as $command) { app($command->command)->process($this, $command->options); } } /** * Run the auto-scaling routine for the supervisor. * * @return void */ protected function autoScale() { $this->lastAutoScaled = $this->lastAutoScaled ?: CarbonImmutable::now()->subSeconds($this->options->balanceCooldown + 1); if (CarbonImmutable::now()->subSeconds($this->options->balanceCooldown)->gte($this->lastAutoScaled)) { $this->lastAutoScaled = CarbonImmutable::now(); app(AutoScaler::class)->scale($this); } } /** * Persist information about this supervisor instance. * * @return void */ public function persist() { app(SupervisorRepository::class)->update($this); } /** * Prune all terminating processes and return the total process count. * * @return int */ public function pruneAndGetTotalProcesses() { $this->pruneTerminatingProcesses(); return $this->totalProcessCount(); } /** * Prune any terminating processes that have finished terminating. * * @return void */ public function pruneTerminatingProcesses() { $this->processPools->each->pruneTerminatingProcesses(); } /** * Get all of the current processes as a collection. * * @return \Illuminate\Support\Collection */ public function processes() { return $this->processPools->map->processes()->collapse(); } /** * Get the processes that are still terminating. * * @return \Illuminate\Support\Collection */ public function terminatingProcesses() { return $this->processPools->map->terminatingProcesses()->collapse(); } /** * Get the total active process count, including processes pending termination. * * @return int */ public function totalProcessCount() { return $this->processPools->sum->totalProcessCount(); } /** * Get the total active process count by asking the OS. * * @return int */ public function totalSystemProcessCount() { return app(SystemProcessCounter::class)->get($this->name); } /** * Get the process ID for this supervisor. * * @return int */ public function pid() { return getmypid(); } /** * Get the current memory usage (in megabytes). * * @return float */ public function memoryUsage() { return memory_get_usage() / 1024 / 1024; } /** * Determine if the supervisor is paused. * * @return bool */ public function isPaused() { return ! $this->working; } /** * Set the output handler. * * @param \Closure $callback * @return $this */ public function handleOutputUsing(Closure $callback) { $this->output = $callback; return $this; } /** * Handle the given output. * * @param string $type * @param string $line * @return void */ public function output($type, $line) { call_user_func($this->output, $type, $line); } /** * Shutdown the supervisor. * * @param int $status * @return void */ protected function exit($status = 0) { $this->exitProcess($status); } /** * Exit the PHP process. * * @param int $status * @return void */ protected function exitProcess($status = 0) { exit((int) $status); } } PK ! kw>/� � SupervisorCommandString.phpnu ȯ�� <?php namespace Laravel\Horizon; class SupervisorCommandString { /** * The base worker command. * * @var string */ public static $command = 'exec @php artisan horizon:supervisor'; /** * Get the command-line representation of the options for a supervisor. * * @param \Laravel\Horizon\SupervisorOptions $options * @return string */ public static function fromOptions(SupervisorOptions $options) { $command = str_replace('@php', PhpBinary::path(), static::$command); return sprintf( "%s {$options->name} {$options->connection} %s", $command, static::toOptionsString($options) ); } /** * Get the additional option string for the command. * * @param \Laravel\Horizon\SupervisorOptions $options * @return string */ public static function toOptionsString(SupervisorOptions $options) { return QueueCommandString::toSupervisorOptionsString($options); } /** * Reset the base command back to its default value. * * @return void */ public static function reset() { static::$command = 'exec @php artisan horizon:supervisor'; } } PK ! S~ � ProcessInspector.phpnu ȯ�� <?php namespace Laravel\Horizon; use Illuminate\Support\Arr; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\Contracts\SupervisorRepository; class ProcessInspector { /** * The command executor. * * @var \Laravel\Horizon\Exec */ public $exec; /** * Create a new process inspector instance. * * @param \Laravel\Horizon\Exec $exec * @return void */ public function __construct(Exec $exec) { $this->exec = $exec; } /** * Get the IDs of all Horizon processes running on the system. * * @return array */ public function current() { return array_diff( $this->exec->run('pgrep -f [h]orizon'), $this->exec->run('pgrep -f horizon:purge') ); } /** * Get an array of running Horizon processes that can't be accounted for. * * @return array */ public function orphaned() { return array_diff($this->current(), $this->monitoring()); } /** * Get all of the process IDs Horizon is actively monitoring. * * @return array */ public function monitoring() { return collect(app(SupervisorRepository::class)->all()) ->pluck('pid') ->pipe(function ($processes) { $processes->each(function ($process) use (&$processes) { $processes = $processes->merge($this->exec->run("pgrep -P {$process}")); }); return $processes; }) ->merge( Arr::pluck(app(MasterSupervisorRepository::class)->all(), 'pid') )->all(); } } PK ! �� � BackgroundProcess.phpnu ȯ�� <?php namespace Laravel\Horizon; use Symfony\Component\Process\Process; class BackgroundProcess extends Process { /** * Destruct the object. * * @return void */ public function __destruct() { // } } PK ! l5� � � EventMap.phpnu ȯ�� <?php namespace Laravel\Horizon; trait EventMap { /** * All of the Horizon event / listener mappings. * * @var array */ protected $events = [ Events\JobPushed::class => [ Listeners\StoreJob::class, Listeners\StoreMonitoredTags::class, ], Events\JobReserved::class => [ Listeners\MarkJobAsReserved::class, Listeners\StartTimingJob::class, ], Events\JobReleased::class => [ Listeners\MarkJobAsReleased::class, ], Events\JobDeleted::class => [ Listeners\MarkJobAsComplete::class, Listeners\UpdateJobMetrics::class, ], Events\JobsMigrated::class => [ Listeners\MarkJobsAsMigrated::class, ], \Illuminate\Queue\Events\JobExceptionOccurred::class => [ Listeners\ForgetJobTimer::class, ], \Illuminate\Queue\Events\JobFailed::class => [ Listeners\ForgetJobTimer::class, Listeners\MarshalFailedEvent::class, ], Events\JobFailed::class => [ Listeners\MarkJobAsFailed::class, Listeners\StoreTagsForFailedJob::class, ], Events\MasterSupervisorLooped::class => [ Listeners\TrimRecentJobs::class, Listeners\TrimFailedJobs::class, Listeners\TrimMonitoredJobs::class, Listeners\ExpireSupervisors::class, Listeners\MonitorMasterSupervisorMemory::class, ], Events\SupervisorLooped::class => [ Listeners\PruneTerminatingProcesses::class, Listeners\MonitorSupervisorMemory::class, Listeners\MonitorWaitTimes::class, ], Events\WorkerProcessRestarting::class => [ // ], Events\SupervisorProcessRestarting::class => [ // ], Events\LongWaitDetected::class => [ Listeners\SendNotification::class, ], ]; } PK ! ��m� � SupervisorProcess.phpnu ȯ�� <?php namespace Laravel\Horizon; use Closure; use Laravel\Horizon\Contracts\HorizonCommandQueue; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\MasterSupervisorCommands\AddSupervisor; use Laravel\Horizon\SupervisorCommands\Terminate; class SupervisorProcess extends WorkerProcess { /** * The name of the supervisor. * * @var string */ public $name; /** * The supervisor process options. * * @var \Laravel\Horizon\SupervisorOptions */ public $options; /** * Indicates if the process is "dead". * * @var bool */ public $dead = false; /** * The exit codes on which supervisor should be marked as dead. * * @var array */ public $dontRestartOn = [ 0, 2, 13, // Indicates duplicate supervisors... ]; /** * Create a new supervisor process instance. * * @param \Laravel\Horizon\SupervisorOptions $options * @param \Symfony\Component\Process\Process $process * @param \Closure|null $output * @return void */ public function __construct(SupervisorOptions $options, $process, Closure $output = null) { $this->options = $options; $this->name = $options->name; $this->output = $output ?: function () { // }; parent::__construct($process); } /** * Evaluate the current state of the process. * * @return void */ public function monitor() { if (! $this->process->isStarted()) { return $this->restart(); } // First, we will check to see if the supervisor failed as a duplicate and if // it did we will go ahead and mark it as dead. We will do this before the // other checks run because we do not care if this is cooling down here. if (! $this->process->isRunning() && $this->process->getExitCode() === 13) { return $this->markAsDead(); } // If the process is running or cooling down from a failure, we don't need to // attempt to do anything right now, so we can just bail out of the method // here and it will get checked out during the next master monitor loop. if ($this->process->isRunning() || $this->coolingDown()) { return; } // Next, we will determine if the exit code is one that means this supervisor // should be marked as dead and not be restarted. Typically, this could be // an indication that the supervisor was simply purposefully terminated. $exitCode = $this->process->getExitCode(); $this->markAsDead(); // If the supervisor exited with a status code that we do not restart on then // we will not attempt to restart it. Otherwise, we will need to provision // it back out based on the latest provisioning information we have now. if (in_array($exitCode, $this->dontRestartOn)) { return; } $this->reprovision(); } /** * Re-provision this supervisor process based on the provisioning plan. * * @return void */ protected function reprovision() { if (isset($this->name)) { app(SupervisorRepository::class)->forget($this->name); } app(HorizonCommandQueue::class)->push( MasterSupervisor::commandQueue(), AddSupervisor::class, $this->options->toArray() ); } /** * Terminate the supervisor with the given status. * * @param int $status * @return void */ public function terminateWithStatus($status) { app(HorizonCommandQueue::class)->push( $this->options->name, Terminate::class, ['status' => $status] ); } /** * Mark the process as "dead". * * @return void */ protected function markAsDead() { $this->dead = true; } } PK ! �v�$� � ServiceBindings.phpnu ȯ�� <?php namespace Laravel\Horizon; trait ServiceBindings { /** * All of the service bindings for Horizon. * * @var array */ public $serviceBindings = [ // General services... AutoScaler::class, Contracts\HorizonCommandQueue::class => RedisHorizonCommandQueue::class, Listeners\TrimRecentJobs::class, Listeners\TrimFailedJobs::class, Listeners\TrimMonitoredJobs::class, Lock::class, Stopwatch::class, // Repository services... Contracts\JobRepository::class => Repositories\RedisJobRepository::class, Contracts\MasterSupervisorRepository::class => Repositories\RedisMasterSupervisorRepository::class, Contracts\MetricsRepository::class => Repositories\RedisMetricsRepository::class, Contracts\ProcessRepository::class => Repositories\RedisProcessRepository::class, Contracts\SupervisorRepository::class => Repositories\RedisSupervisorRepository::class, Contracts\TagRepository::class => Repositories\RedisTagRepository::class, Contracts\WorkloadRepository::class => Repositories\RedisWorkloadRepository::class, ]; } PK ! e�ten" n" MasterSupervisor.phpnu ȯ�� <?php namespace Laravel\Horizon; use Carbon\CarbonImmutable; use Closure; use Exception; use Illuminate\Contracts\Cache\Factory as CacheFactory; use Illuminate\Contracts\Debug\ExceptionHandler; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\HorizonCommandQueue; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\Contracts\Pausable; use Laravel\Horizon\Contracts\Restartable; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\Contracts\Terminable; use Laravel\Horizon\Events\MasterSupervisorLooped; use Throwable; class MasterSupervisor implements Pausable, Restartable, Terminable { use ListensForSignals; /** * The environment that was used to provision this master supervisor. * * @var string|null */ public $environment; /** * The name of the master supervisor. * * @var string */ public $name; /** * All of the supervisors managed. * * @var \Illuminate\Support\Collection */ public $supervisors; /** * Indicates if the master supervisor process is working. * * @var bool */ public $working = true; /** * The output handler. * * @var \Closure|null */ public $output; /** * The callback to use to resolve master supervisor names. * * @var \Closure|null */ public static $nameResolver; /** * Create a new master supervisor instance. * * @param string $environment * @return void */ public function __construct(string $environment = null) { $this->environment = $environment; $this->name = static::name(); $this->supervisors = collect(); $this->output = function () { // }; app(HorizonCommandQueue::class)->flush($this->commandQueue()); } /** * Get the name for this master supervisor. * * @return string */ public static function name() { static $token; if (! $token) { $token = Str::random(4); } return static::basename().'-'.$token; } /** * Get the basename for the machine's master supervisors. * * @return string */ public static function basename() { return static::$nameResolver ? call_user_func(static::$nameResolver) : Str::slug(gethostname()); } /** * Use the given callback to resolve master supervisor names. * * @param \Closure $callback * @return void */ public static function determineNameUsing(Closure $callback) { static::$nameResolver = $callback; } /** * Terminate all current supervisors and start fresh ones. * * @return void */ public function restart() { $this->working = true; $this->supervisors->each->terminateWithStatus(1); } /** * Pause the supervisors. * * @return void */ public function pause() { $this->working = false; $this->supervisors->each->pause(); } /** * Instruct the supervisors to continue working. * * @return void */ public function continue() { $this->working = true; $this->supervisors->each->continue(); } /** * Terminate this master supervisor and all of its supervisors. * * @param int $status * @return void */ public function terminate($status = 0) { $this->working = false; // First we will terminate all child supervisors so they will gracefully scale // down to zero. We'll also grab the longest expiration times of any of the // active supervisors so we know the maximum amount of time to wait here. $longest = app(SupervisorRepository::class) ->longestActiveTimeout(); $this->supervisors->each->terminate(); // We will go ahead and remove this master supervisor's record from storage so // another master supervisor could get started in its place without waiting // for it to really finish terminating all of its underlying supervisors. app(MasterSupervisorRepository::class) ->forget($this->name); $startedTerminating = CarbonImmutable::now(); // Here we will wait until all of the child supervisors finish terminating and // then exit the process. We will keep track of a timeout value so that the // process does not get stuck in an infinite loop here waiting for these. while (count($this->supervisors->filter->isRunning())) { if (CarbonImmutable::now()->subSeconds($longest) ->gte($startedTerminating)) { break; } sleep(1); } if (config('horizon.fast_termination')) { app(CacheFactory::class)->forget('horizon:terminate:wait'); } $this->exit($status); } /** * Monitor the worker processes. * * @return void */ public function monitor() { $this->ensureNoOtherMasterSupervisors(); $this->listenForSignals(); $this->persist(); while (true) { sleep(1); $this->loop(); } } /** * Ensure that this is the only master supervisor running for this machine. * * @return void * * @throws \Exception */ public function ensureNoOtherMasterSupervisors() { if (app(MasterSupervisorRepository::class)->find($this->name) !== null) { throw new Exception('A master supervisor is already running on this machine.'); } } /** * Perform a monitor loop. * * @return void */ public function loop() { try { $this->processPendingSignals(); $this->processPendingCommands(); if ($this->working) { $this->monitorSupervisors(); } $this->persist(); event(new MasterSupervisorLooped($this)); } catch (Throwable $e) { app(ExceptionHandler::class)->report($e); } } /** * Handle any pending commands for the master supervisor. * * @return void */ protected function processPendingCommands() { foreach (app(HorizonCommandQueue::class)->pending($this->commandQueue()) as $command) { app($command->command)->process($this, $command->options); } } /** * "Monitor" all of the supervisors. * * @return void */ protected function monitorSupervisors() { $this->supervisors->each->monitor(); $this->supervisors = $this->supervisors->reject->dead; } /** * Persist information about the master supervisor instance. * * @return void */ public function persist() { app(MasterSupervisorRepository::class)->update($this); } /** * Get the process ID for this supervisor. * * @return int */ public function pid() { return getmypid(); } /** * Get the current memory usage (in megabytes). * * @return float */ public function memoryUsage() { return memory_get_usage() / 1024 / 1024; } /** * Get the name of the command queue for the master supervisor. * * @return string */ public static function commandQueue() { return 'master:'.static::name(); } /** * Get the name of the command queue for the given master supervisor. * * @param string|null $name * @return string */ public static function commandQueueFor($name = null) { return $name ? 'master:'.$name : static::commandQueue(); } /** * Set the output handler. * * @param \Closure $callback * @return $this */ public function handleOutputUsing(Closure $callback) { $this->output = $callback; return $this; } /** * Handle the given output. * * @param string $type * @param string $line * @return void */ public function output($type, $line) { call_user_func($this->output, $type, $line); } /** * Shutdown the supervisor. * * @param int $status * @return void */ protected function exit($status = 0) { $this->exitProcess($status); } /** * Exit the PHP process. * * @param int $status * @return void */ protected function exitProcess($status = 0) { exit((int) $status); } } PK ! �.� � ( Repositories/RedisWorkloadRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Repositories; use Illuminate\Contracts\Queue\Factory as QueueFactory; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\Contracts\WorkloadRepository; use Laravel\Horizon\WaitTimeCalculator; class RedisWorkloadRepository implements WorkloadRepository { /** * The queue factory implementation. * * @var \Illuminate\Contracts\Queue\Factory */ public $queue; /** * The wait time calculator instance. * * @var \Laravel\Horizon\WaitTimeCalculator */ public $waitTime; /** * The master supervisor repository implementation. * * @var \Laravel\Horizon\Contracts\MasterSupervisorRepository */ private $masters; /** * The supervisor repository implementation. * * @var \Laravel\Horizon\Contracts\SupervisorRepository */ private $supervisors; /** * Create a new repository instance. * * @param \Illuminate\Contracts\Queue\Factory $queue * @param \Laravel\Horizon\WaitTimeCalculator $waitTime * @param \Laravel\Horizon\Contracts\MasterSupervisorRepository $masters * @param \Laravel\Horizon\Contracts\SupervisorRepository $supervisors * @return void */ public function __construct(QueueFactory $queue, WaitTimeCalculator $waitTime, MasterSupervisorRepository $masters, SupervisorRepository $supervisors) { $this->queue = $queue; $this->masters = $masters; $this->waitTime = $waitTime; $this->supervisors = $supervisors; } /** * Get the current workload of each queue. * * @return array */ public function get() { $processes = $this->processes(); return collect($this->waitTime->calculate()) ->map(function ($waitTime, $queue) use ($processes) { [$connection, $queueName] = explode(':', $queue, 2); $totalProcesses = $processes[$queue] ?? 0; $length = ! Str::contains($queue, ',') ? collect([$queueName => $this->queue->connection($connection)->readyNow($queueName)]) : collect(explode(',', $queueName))->mapWithKeys(function ($queueName) use ($connection) { return [$queueName => $this->queue->connection($connection)->readyNow($queueName)]; }); $splitQueues = Str::contains($queue, ',') ? $length->map(function ($length, $queueName) use ($connection, $totalProcesses, &$wait) { return [ 'name' => $queueName, 'length' => $length, 'wait' => $wait += $this->waitTime->calculateTimeToClear($connection, $queueName, $totalProcesses), ]; }) : null; return [ 'name' => $queueName, 'length' => $length->sum(), 'wait' => $waitTime, 'processes' => $totalProcesses, 'split_queues' => $splitQueues, ]; })->values()->toArray(); } /** * Get the number of processes of each queue. * * @return array */ private function processes() { return collect($this->supervisors->all())->pluck('processes')->reduce(function ($final, $queues) { foreach ($queues as $queue => $processes) { $final[$queue] = isset($final[$queue]) ? $final[$queue] + $processes : $processes; } return $final; }, []); } } PK ! y2�D� � * Repositories/RedisSupervisorRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Repositories; use Carbon\CarbonImmutable; use Illuminate\Contracts\Redis\Factory as RedisFactory; use Illuminate\Support\Arr; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\Supervisor; class RedisSupervisorRepository implements SupervisorRepository { /** * The Redis connection instance. * * @var \Illuminate\Contracts\Redis\Factory */ public $redis; /** * Create a new repository instance. * * @param \Illuminate\Contracts\Redis\Factory $redis * @return void */ public function __construct(RedisFactory $redis) { $this->redis = $redis; } /** * Get the names of all the supervisors currently running. * * @return array */ public function names() { return $this->connection()->zrevrangebyscore('supervisors', '+inf', CarbonImmutable::now()->subSeconds(29)->getTimestamp() ); } /** * Get information on all of the supervisors. * * @return array */ public function all() { return $this->get($this->names()); } /** * Get information on a supervisor by name. * * @param string $name * @return \stdClass|null */ public function find($name) { return Arr::get($this->get([$name]), 0); } /** * Get information on the given supervisors. * * @param array $names * @return array */ public function get(array $names) { $records = $this->connection()->pipeline(function ($pipe) use ($names) { foreach ($names as $name) { $pipe->hmget('supervisor:'.$name, ['name', 'master', 'pid', 'status', 'processes', 'options']); } }); return collect($records)->filter()->map(function ($record) { $record = array_values($record); return ! $record[0] ? null : (object) [ 'name' => $record[0], 'master' => $record[1], 'pid' => $record[2], 'status' => $record[3], 'processes' => json_decode($record[4], true), 'options' => json_decode($record[5], true), ]; })->filter()->all(); } /** * Get the longest active timeout setting for a supervisor. * * @return int */ public function longestActiveTimeout() { return collect($this->all())->max(function ($supervisor) { return $supervisor->options['timeout']; }) ?: 0; } /** * Update the information about the given supervisor process. * * @param \Laravel\Horizon\Supervisor $supervisor * @return void */ public function update(Supervisor $supervisor) { $processes = $supervisor->processPools->mapWithKeys(function ($pool) use ($supervisor) { return [$supervisor->options->connection.':'.$pool->queue() => count($pool->processes())]; })->toJson(); $this->connection()->pipeline(function ($pipe) use ($supervisor, $processes) { $pipe->hmset( 'supervisor:'.$supervisor->name, [ 'name' => $supervisor->name, 'master' => implode(':', explode(':', $supervisor->name, -1)), 'pid' => $supervisor->pid(), 'status' => $supervisor->working ? 'running' : 'paused', 'processes' => $processes, 'options' => $supervisor->options->toJson(), ] ); $pipe->zadd('supervisors', CarbonImmutable::now()->getTimestamp(), $supervisor->name ); $pipe->expire('supervisor:'.$supervisor->name, 30); }); } /** * Remove the supervisor information from storage. * * @param array|string $names * @return void */ public function forget($names) { $names = (array) $names; if (empty($names)) { return; } $this->connection()->del(...collect($names)->map(function ($name) { return 'supervisor:'.$name; })->all()); $this->connection()->zrem('supervisors', ...$names); } /** * Remove expired supervisors from storage. * * @return void */ public function flushExpired() { $this->connection()->zremrangebyscore('supervisors', '-inf', CarbonImmutable::now()->subSeconds(14)->getTimestamp() ); } /** * Get the Redis connection instance. * * @return \Illuminate\Redis\Connections\Connection */ protected function connection() { return $this->redis->connection('horizon'); } } PK ! ���V� � 0 Repositories/RedisMasterSupervisorRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Repositories; use Carbon\CarbonImmutable; use Illuminate\Contracts\Redis\Factory as RedisFactory; use Illuminate\Support\Arr; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\MasterSupervisor; class RedisMasterSupervisorRepository implements MasterSupervisorRepository { /** * The Redis connection instance. * * @var \Illuminate\Contracts\Redis\Factory */ public $redis; /** * Create a new repository instance. * * @param \Illuminate\Contracts\Redis\Factory $redis * @return void */ public function __construct(RedisFactory $redis) { $this->redis = $redis; } /** * Get the names of all the master supervisors currently running. * * @return array */ public function names() { return $this->connection()->zrevrangebyscore('masters', '+inf', CarbonImmutable::now()->subSeconds(14)->getTimestamp() ); } /** * Get information on all of the supervisors. * * @return array */ public function all() { return $this->get($this->names()); } /** * Get information on a master supervisor by name. * * @param string $name * @return \stdClass|null */ public function find($name) { return Arr::get($this->get([$name]), 0); } /** * Get information on the given master supervisors. * * @param array $names * @return array */ public function get(array $names) { $records = $this->connection()->pipeline(function ($pipe) use ($names) { foreach ($names as $name) { $pipe->hmget('master:'.$name, ['name', 'pid', 'status', 'supervisors', 'environment']); } }); return collect($records)->map(function ($record) { $record = array_values($record); return ! $record[0] ? null : (object) [ 'name' => $record[0], 'environment' => $record[4], 'pid' => $record[1], 'status' => $record[2], 'supervisors' => json_decode($record[3], true), ]; })->filter()->all(); } /** * Update the information about the given master supervisor. * * @param \Laravel\Horizon\MasterSupervisor $master * @return void */ public function update(MasterSupervisor $master) { $supervisors = $master->supervisors->map->name->all(); $this->connection()->pipeline(function ($pipe) use ($master, $supervisors) { $pipe->hmset( 'master:'.$master->name, [ 'name' => $master->name, 'environment' => $master->environment, 'pid' => $master->pid(), 'status' => $master->working ? 'running' : 'paused', 'supervisors' => json_encode($supervisors), ] ); $pipe->zadd('masters', CarbonImmutable::now()->getTimestamp(), $master->name ); $pipe->expire('master:'.$master->name, 15); }); } /** * Remove the master supervisor information from storage. * * @param string $name * @return void */ public function forget($name) { if (! $master = $this->find($name)) { return; } app(SupervisorRepository::class)->forget( $master->supervisors ); $this->connection()->del('master:'.$name); $this->connection()->zrem('masters', $name); } /** * Remove expired master supervisors from storage. * * @return void */ public function flushExpired() { $this->connection()->zremrangebyscore('masters', '-inf', CarbonImmutable::now()->subSeconds(14)->getTimestamp() ); } /** * Get the Redis connection instance. * * @return \Illuminate\Redis\Connections\Connection */ protected function connection() { return $this->redis->connection('horizon'); } } PK ! ��F� � ' Repositories/RedisProcessRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Repositories; use Carbon\CarbonImmutable; use Illuminate\Contracts\Redis\Factory as RedisFactory; use Laravel\Horizon\Contracts\ProcessRepository; class RedisProcessRepository implements ProcessRepository { /** * The Redis connection instance. * * @var \Illuminate\Contracts\Redis\Factory */ public $redis; /** * Create a new repository instance. * * @param \Illuminate\Contracts\Redis\Factory $redis * @return void */ public function __construct(RedisFactory $redis) { $this->redis = $redis; } /** * Get all of the orphan process IDs and the times they were observed. * * @param string $master * @return array */ public function allOrphans($master) { return $this->connection()->hgetall( "{$master}:orphans" ); } /** * Record the given process IDs as orphaned. * * @param string $master * @param array $processIds * @return void */ public function orphaned($master, array $processIds) { $time = CarbonImmutable::now()->getTimestamp(); $shouldRemove = array_diff($this->connection()->hkeys( $key = "{$master}:orphans" ), $processIds); if (! empty($shouldRemove)) { $this->connection()->hdel($key, ...$shouldRemove); } $this->connection()->pipeline(function ($pipe) use ($key, $time, $processIds) { foreach ($processIds as $processId) { $pipe->hsetnx($key, $processId, $time); } }); } /** * Get the process IDs orphaned for at least the given number of seconds. * * @param string $master * @param int $seconds * @return array */ public function orphanedFor($master, $seconds) { $expiresAt = CarbonImmutable::now()->getTimestamp() - $seconds; return collect($this->allOrphans($master))->filter(function ($recordedAt, $_) use ($expiresAt) { return $expiresAt > $recordedAt; })->keys()->all(); } /** * Remove the given process IDs from the orphan list. * * @param string $master * @param array $processIds * @return void */ public function forgetOrphans($master, array $processIds) { $this->connection()->hdel( "{$master}:orphans", ...$processIds ); } /** * Get the Redis connection instance. * * @return \Illuminate\Redis\Connections\Connection */ protected function connection() { return $this->redis->connection('horizon'); } } PK ! �KQvQ vQ # Repositories/RedisJobRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Repositories; use Carbon\CarbonImmutable; use Illuminate\Contracts\Redis\Factory as RedisFactory; use Illuminate\Support\Arr; use Illuminate\Support\Collection; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\JobPayload; use Laravel\Horizon\LuaScripts; class RedisJobRepository implements JobRepository { /** * The Redis connection instance. * * @var \Illuminate\Contracts\Redis\Factory */ public $redis; /** * The keys stored on the job hashes. * * @var array */ public $keys = [ 'id', 'connection', 'queue', 'name', 'status', 'payload', 'exception', 'context', 'failed_at', 'completed_at', 'retried_by', 'reserved_at', ]; /** * The number of minutes until recently failed jobs should be purged. * * @var int */ public $recentFailedJobExpires; /** * The number of minutes until recent jobs should be purged. * * @var int */ public $recentJobExpires; /** * The number of minutes until pending jobs should be purged. * * @var int */ public $pendingJobExpires; /** * The number of minutes until completed and silenced jobs should be purged. * * @var int */ public $completedJobExpires; /** * The number of minutes until failed jobs should be purged. * * @var int */ public $failedJobExpires; /** * The number of minutes until monitored jobs should be purged. * * @var int */ public $monitoredJobExpires; /** * Create a new repository instance. * * @param \Illuminate\Contracts\Redis\Factory $redis * @return void */ public function __construct(RedisFactory $redis) { $this->redis = $redis; $this->recentJobExpires = config('horizon.trim.recent', 60); $this->pendingJobExpires = config('horizon.trim.pending', 60); $this->completedJobExpires = config('horizon.trim.completed', 60); $this->failedJobExpires = config('horizon.trim.failed', 10080); $this->recentFailedJobExpires = config('horizon.trim.recent_failed', $this->failedJobExpires); $this->monitoredJobExpires = config('horizon.trim.monitored', 10080); } /** * Get the next job ID that should be assigned. * * @return string */ public function nextJobId() { return (string) $this->connection()->incr('job_id'); } /** * Get the total count of recent jobs. * * @return int */ public function totalRecent() { return $this->connection()->zcard('recent_jobs'); } /** * Get the total count of failed jobs. * * @return int */ public function totalFailed() { return $this->connection()->zcard('failed_jobs'); } /** * Get a chunk of recent jobs. * * @param string|null $afterIndex * @return \Illuminate\Support\Collection */ public function getRecent($afterIndex = null) { return $this->getJobsByType('recent_jobs', $afterIndex); } /** * Get a chunk of failed jobs. * * @param string|null $afterIndex * @return \Illuminate\Support\Collection */ public function getFailed($afterIndex = null) { return $this->getJobsByType('failed_jobs', $afterIndex); } /** * Get a chunk of pending jobs. * * @param string|null $afterIndex * @return \Illuminate\Support\Collection */ public function getPending($afterIndex = null) { return $this->getJobsByType('pending_jobs', $afterIndex); } /** * Get a chunk of completed jobs. * * @param string|null $afterIndex * @return \Illuminate\Support\Collection */ public function getCompleted($afterIndex = null) { return $this->getJobsByType('completed_jobs', $afterIndex); } /** * Get a chunk of silenced jobs. * * @param string|null $afterIndex * @return \Illuminate\Support\Collection */ public function getSilenced($afterIndex = null) { return $this->getJobsByType('silenced_jobs', $afterIndex); } /** * Get the count of recent jobs. * * @return int */ public function countRecent() { return $this->countJobsByType('recent_jobs'); } /** * Get the count of failed jobs. * * @return int */ public function countFailed() { return $this->countJobsByType('failed_jobs'); } /** * Get the count of pending jobs. * * @return int */ public function countPending() { return $this->countJobsByType('pending_jobs'); } /** * Get the count of completed jobs. * * @return int */ public function countCompleted() { return $this->countJobsByType('completed_jobs'); } /** * Get the count of silenced jobs. * * @return int */ public function countSilenced() { return $this->countJobsByType('silenced_jobs'); } /** * Get the count of the recently failed jobs. * * @return int */ public function countRecentlyFailed() { return $this->countJobsByType('recent_failed_jobs'); } /** * Get a chunk of jobs from the given type set. * * @param string $type * @param string $afterIndex * @return \Illuminate\Support\Collection */ protected function getJobsByType($type, $afterIndex) { $afterIndex = $afterIndex === null ? -1 : $afterIndex; return $this->getJobs($this->connection()->zrange( $type, $afterIndex + 1, $afterIndex + 50 ), $afterIndex + 1); } /** * Get the number of jobs in a given type set. * * @param string $type * @return int */ protected function countJobsByType($type) { $minutes = $this->minutesForType($type); return $this->connection()->zcount( $type, '-inf', CarbonImmutable::now()->subMinutes($minutes)->getTimestamp() * -1 ); } /** * Get the number of minutes to count for a given type set. * * @param string $type * @return int */ protected function minutesForType($type) { return match ($type) { 'failed_jobs' => $this->failedJobExpires, 'recent_failed_jobs' => $this->recentFailedJobExpires, 'pending_jobs' => $this->pendingJobExpires, 'completed_jobs' => $this->completedJobExpires, 'silenced_jobs' => $this->completedJobExpires, default => $this->recentJobExpires, }; } /** * Retrieve the jobs with the given IDs. * * @param array $ids * @param mixed $indexFrom * @return \Illuminate\Support\Collection */ public function getJobs(array $ids, $indexFrom = 0) { $jobs = $this->connection()->pipeline(function ($pipe) use ($ids) { foreach ($ids as $id) { $pipe->hmget($id, $this->keys); } }); return $this->indexJobs(collect($jobs)->filter(function ($job) { $job = is_array($job) ? array_values($job) : null; return is_array($job) && $job[0] !== null && $job[0] !== false; })->values(), $indexFrom); } /** * Index the given jobs from the given index. * * @param \Illuminate\Support\Collection $jobs * @param int $indexFrom * @return \Illuminate\Support\Collection */ protected function indexJobs($jobs, $indexFrom) { return $jobs->map(function ($job) use (&$indexFrom) { $job = (object) array_combine($this->keys, $job); $job->index = $indexFrom; $indexFrom++; return $job; }); } /** * Insert the job into storage. * * @param string $connection * @param string $queue * @param \Laravel\Horizon\JobPayload $payload * @return void */ public function pushed($connection, $queue, JobPayload $payload) { $this->connection()->pipeline(function ($pipe) use ($connection, $queue, $payload) { $this->storeJobReference($pipe, 'recent_jobs', $payload); $this->storeJobReference($pipe, 'pending_jobs', $payload); $time = str_replace(',', '.', microtime(true)); $pipe->hmset($payload->id(), [ 'id' => $payload->id(), 'connection' => $connection, 'queue' => $queue, 'name' => $payload->decoded['displayName'], 'status' => 'pending', 'payload' => $payload->value, 'created_at' => $time, 'updated_at' => $time, ]); $pipe->expireat( $payload->id(), CarbonImmutable::now()->addMinutes($this->pendingJobExpires)->getTimestamp() ); }); } /** * Mark the job as reserved. * * @param string $connection * @param string $queue * @param \Laravel\Horizon\JobPayload $payload * @return void */ public function reserved($connection, $queue, JobPayload $payload) { $time = str_replace(',', '.', microtime(true)); $this->connection()->hmset( $payload->id(), [ 'status' => 'reserved', 'payload' => $payload->value, 'updated_at' => $time, 'reserved_at' => $time, ] ); } /** * Mark the job as released / pending. * * @param string $connection * @param string $queue * @param \Laravel\Horizon\JobPayload $payload * @return void */ public function released($connection, $queue, JobPayload $payload) { $this->connection()->hmset( $payload->id(), [ 'status' => 'pending', 'payload' => $payload->value, 'updated_at' => str_replace(',', '.', microtime(true)), ] ); } /** * Mark the job as completed and monitored. * * @param string $connection * @param string $queue * @param \Laravel\Horizon\JobPayload $payload * @return void */ public function remember($connection, $queue, JobPayload $payload) { $this->connection()->pipeline(function ($pipe) use ($connection, $queue, $payload) { $this->storeJobReference($pipe, 'monitored_jobs', $payload); $pipe->hmset( $payload->id(), [ 'id' => $payload->id(), 'connection' => $connection, 'queue' => $queue, 'name' => $payload->decoded['displayName'], 'status' => 'completed', 'payload' => $payload->value, 'completed_at' => str_replace(',', '.', microtime(true)), ] ); $pipe->expireat( $payload->id(), CarbonImmutable::now()->addMinutes($this->monitoredJobExpires)->getTimestamp() ); }); } /** * Mark the given jobs as released / pending. * * @param string $connection * @param string $queue * @param \Illuminate\Support\Collection $payloads * @return void */ public function migrated($connection, $queue, Collection $payloads) { $this->connection()->pipeline(function ($pipe) use ($payloads) { foreach ($payloads as $payload) { $pipe->hmset( $payload->id(), [ 'status' => 'pending', 'payload' => $payload->value, 'updated_at' => str_replace(',', '.', microtime(true)), ] ); } }); } /** * Handle the storage of a completed job. * * @param \Laravel\Horizon\JobPayload $payload * @param bool $failed * @param bool $silenced * @return void */ public function completed(JobPayload $payload, $failed = false, $silenced = false) { if ($payload->isRetry()) { $this->updateRetryInformationOnParent($payload, $failed); } $this->connection()->pipeline(function ($pipe) use ($payload, $silenced) { $this->storeJobReference($pipe, $silenced ? 'silenced_jobs' : 'completed_jobs', $payload); $this->removeJobReference($pipe, 'pending_jobs', $payload); $pipe->hmset( $payload->id(), [ 'status' => 'completed', 'completed_at' => str_replace(',', '.', microtime(true)), ] ); $pipe->expireat($payload->id(), CarbonImmutable::now()->addMinutes($this->completedJobExpires)->getTimestamp()); }); } /** * Update the retry status of a job's parent. * * @param \Laravel\Horizon\JobPayload $payload * @param bool $failed * @return void */ protected function updateRetryInformationOnParent(JobPayload $payload, $failed) { if ($retries = $this->connection()->hget($payload->retryOf(), 'retried_by')) { $retries = $this->updateRetryStatus( $payload, json_decode($retries, true), $failed ); $this->connection()->hset( $payload->retryOf(), 'retried_by', json_encode($retries) ); } } /** * Update the retry status of a job in a retry array. * * @param \Laravel\Horizon\JobPayload $payload * @param array $retries * @param bool $failed * @return array */ protected function updateRetryStatus(JobPayload $payload, $retries, $failed) { return collect($retries)->map(function ($retry) use ($payload, $failed) { return $retry['id'] === $payload->id() ? Arr::set($retry, 'status', $failed ? 'failed' : 'completed') : $retry; })->all(); } /** * Delete the given monitored jobs by IDs. * * @param array $ids * @return void */ public function deleteMonitored(array $ids) { $this->connection()->pipeline(function ($pipe) use ($ids) { foreach ($ids as $id) { $pipe->expireat($id, CarbonImmutable::now()->addDays(7)->getTimestamp()); } }); } /** * Trim the recent job list. * * @return void */ public function trimRecentJobs() { $this->connection()->pipeline(function ($pipe) { $pipe->zremrangebyscore( 'recent_jobs', CarbonImmutable::now()->subMinutes($this->recentJobExpires)->getTimestamp() * -1, '+inf' ); $pipe->zremrangebyscore( 'recent_failed_jobs', CarbonImmutable::now()->subMinutes($this->recentFailedJobExpires)->getTimestamp() * -1, '+inf' ); $pipe->zremrangebyscore( 'pending_jobs', CarbonImmutable::now()->subMinutes($this->pendingJobExpires)->getTimestamp() * -1, '+inf' ); $pipe->zremrangebyscore( 'completed_jobs', CarbonImmutable::now()->subMinutes($this->completedJobExpires)->getTimestamp() * -1, '+inf' ); $pipe->zremrangebyscore( 'silenced_jobs', CarbonImmutable::now()->subMinutes($this->completedJobExpires)->getTimestamp() * -1, '+inf' ); }); } /** * Trim the failed job list. * * @return void */ public function trimFailedJobs() { $this->connection()->zremrangebyscore( 'failed_jobs', CarbonImmutable::now()->subMinutes($this->failedJobExpires)->getTimestamp() * -1, '+inf' ); } /** * Trim the monitored job list. * * @return void */ public function trimMonitoredJobs() { $this->connection()->zremrangebyscore( 'monitored_jobs', CarbonImmutable::now()->subMinutes($this->monitoredJobExpires)->getTimestamp() * -1, '+inf' ); } /** * Find a failed job by ID. * * @param string $id * @return \stdClass|null */ public function findFailed($id) { $attributes = $this->connection()->hmget( $id, $this->keys ); $job = is_array($attributes) && $attributes[0] !== null ? (object) array_combine($this->keys, $attributes) : null; if ($job && $job->status !== 'failed') { return; } return $job; } /** * Mark the job as failed. * * @param \Exception $exception * @param string $connection * @param string $queue * @param \Laravel\Horizon\JobPayload $payload * @return void */ public function failed($exception, $connection, $queue, JobPayload $payload) { $this->connection()->pipeline(function ($pipe) use ($exception, $connection, $queue, $payload) { $this->storeJobReference($pipe, 'failed_jobs', $payload); $this->storeJobReference($pipe, 'recent_failed_jobs', $payload); $this->removeJobReference($pipe, 'pending_jobs', $payload); $this->removeJobReference($pipe, 'completed_jobs', $payload); $this->removeJobReference($pipe, 'silenced_jobs', $payload); $pipe->hmset( $payload->id(), [ 'id' => $payload->id(), 'connection' => $connection, 'queue' => $queue, 'name' => $payload->decoded['displayName'], 'status' => 'failed', 'payload' => $payload->value, 'exception' => (string) $exception, 'context' => method_exists($exception, 'context') ? json_encode($exception->context()) : null, 'failed_at' => str_replace(',', '.', microtime(true)), ] ); $pipe->expireat( $payload->id(), CarbonImmutable::now()->addMinutes($this->failedJobExpires)->getTimestamp() ); }); } /** * Store the look-up references for a job. * * @param mixed $pipe * @param string $key * @param \Laravel\Horizon\JobPayload $payload * @return void */ protected function storeJobReference($pipe, $key, JobPayload $payload) { $pipe->zadd($key, str_replace(',', '.', microtime(true) * -1), $payload->id()); } /** * Remove the look-up references for a job. * * @param mixed $pipe * @param string $key * @param \Laravel\Horizon\JobPayload $payload * @return void */ protected function removeJobReference($pipe, $key, JobPayload $payload) { $pipe->zrem($key, $payload->id()); } /** * Store the retry job ID on the original job record. * * @param string $id * @param string $retryId * @return void */ public function storeRetryReference($id, $retryId) { $retries = json_decode($this->connection()->hget($id, 'retried_by') ?: '[]'); $retries[] = [ 'id' => $retryId, 'status' => 'pending', 'retried_at' => CarbonImmutable::now()->getTimestamp(), ]; $this->connection()->hmset($id, ['retried_by' => json_encode($retries)]); } /** * Delete a failed job by ID. * * @param string $id * @return int */ public function deleteFailed($id) { return $this->connection()->zrem('failed_jobs', $id) != 1 ? 0 : $this->connection()->del($id); } /** * Delete pending and reserved jobs for a queue. * * @param string $queue * @return int */ public function purge($queue) { return $this->connection()->eval( LuaScripts::purge(), 2, 'recent_jobs', 'pending_jobs', config('horizon.prefix'), $queue ); } /** * Get the Redis connection instance. * * @return \Illuminate\Redis\Connections\Connection */ protected function connection() { return $this->redis->connection('horizon'); } } PK ! ��<�� � # Repositories/RedisTagRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Repositories; use Illuminate\Contracts\Redis\Factory as RedisFactory; use Laravel\Horizon\Contracts\TagRepository; class RedisTagRepository implements TagRepository { /** * The Redis connection instance. * * @var \Illuminate\Contracts\Redis\Factory */ public $redis; /** * Create a new repository instance. * * @param \Illuminate\Contracts\Redis\Factory $redis * @return void */ public function __construct(RedisFactory $redis) { $this->redis = $redis; } /** * Get the currently monitored tags. * * @return array */ public function monitoring() { return (array) $this->connection()->smembers('monitoring'); } /** * Return the tags which are being monitored. * * @param array $tags * @return array */ public function monitored(array $tags) { return array_intersect($tags, $this->monitoring()); } /** * Start monitoring the given tag. * * @param string $tag * @return void */ public function monitor($tag) { $this->connection()->sadd('monitoring', $tag); } /** * Stop monitoring the given tag. * * @param string $tag * @return void */ public function stopMonitoring($tag) { $this->connection()->srem('monitoring', $tag); } /** * Store the tags for the given job. * * @param string $id * @param array $tags * @return void */ public function add($id, array $tags) { $this->connection()->pipeline(function ($pipe) use ($id, $tags) { foreach ($tags as $tag) { $pipe->zadd($tag, str_replace(',', '.', microtime(true)), $id); } }); } /** * Store the tags for the given job temporarily. * * @param int $minutes * @param string $id * @param array $tags * @return void */ public function addTemporary($minutes, $id, array $tags) { $this->connection()->pipeline(function ($pipe) use ($minutes, $id, $tags) { foreach ($tags as $tag) { $pipe->zadd($tag, str_replace(',', '.', microtime(true)), $id); $pipe->expire($tag, $minutes * 60); } }); } /** * Get the number of jobs matching a given tag. * * @param string $tag * @return int */ public function count($tag) { return $this->connection()->zcard($tag); } /** * Get all of the job IDs for a given tag. * * @param string $tag * @return array */ public function jobs($tag) { return (array) $this->connection()->zrange($tag, 0, -1); } /** * Paginate the job IDs for a given tag. * * @param string $tag * @param int $startingAt * @param int $limit * @return array */ public function paginate($tag, $startingAt = 0, $limit = 25) { $tags = (array) $this->connection()->zrevrange( $tag, $startingAt, $startingAt + $limit - 1 ); return collect($tags)->values()->mapWithKeys(function ($tag, $index) use ($startingAt) { return [$index + $startingAt => $tag]; })->all(); } /** * Remove the given job IDs from the given tag. * * @param array|string $tags * @param array|string $ids * @return void */ public function forgetJobs($tags, $ids) { $this->connection()->pipeline(function ($pipe) use ($tags, $ids) { foreach ((array) $tags as $tag) { foreach ((array) $ids as $id) { $pipe->zrem($tag, $id); } } }); } /** * Delete the given tag from storage. * * @param string $tag * @return void */ public function forget($tag) { $this->connection()->del($tag); } /** * Get the Redis connection instance. * * @return \Illuminate\Redis\Connections\Connection */ protected function connection() { return $this->redis->connection('horizon'); } } PK ! I��.�) �) ' Repositories/RedisMetricsRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Repositories; use Carbon\CarbonImmutable; use Illuminate\Contracts\Redis\Factory as RedisFactory; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\MetricsRepository; use Laravel\Horizon\Lock; use Laravel\Horizon\LuaScripts; use Laravel\Horizon\WaitTimeCalculator; class RedisMetricsRepository implements MetricsRepository { /** * The Redis connection instance. * * @var \Illuminate\Contracts\Redis\Factory */ public $redis; /** * Create a new repository instance. * * @param \Illuminate\Contracts\Redis\Factory $redis * @return void */ public function __construct(RedisFactory $redis) { $this->redis = $redis; } /** * Get all of the class names that have metrics measurements. * * @return array */ public function measuredJobs() { $classes = (array) $this->connection()->smembers('measured_jobs'); return collect($classes)->map(function ($class) { return preg_match('/job:(.*)$/', $class, $matches) ? $matches[1] : $class; })->sort()->values()->all(); } /** * Get all of the queues that have metrics measurements. * * @return array */ public function measuredQueues() { $queues = (array) $this->connection()->smembers('measured_queues'); return collect($queues)->map(function ($class) { return preg_match('/queue:(.*)$/', $class, $matches) ? $matches[1] : $class; })->sort()->values()->all(); } /** * Get the jobs processed per minute since the last snapshot. * * @return float */ public function jobsProcessedPerMinute() { return round($this->throughput() / $this->minutesSinceLastSnapshot()); } /** * Get the application's total throughput since the last snapshot. * * @return int */ public function throughput() { return collect($this->measuredQueues())->reduce(function ($carry, $queue) { return $carry + $this->connection()->hget('queue:'.$queue, 'throughput'); }, 0); } /** * Get the throughput for a given job. * * @param string $job * @return int */ public function throughputForJob($job) { return $this->throughputFor('job:'.$job); } /** * Get the throughput for a given queue. * * @param string $queue * @return int */ public function throughputForQueue($queue) { return $this->throughputFor('queue:'.$queue); } /** * Get the throughput for a given key. * * @param string $key * @return int */ protected function throughputFor($key) { return (int) $this->connection()->hget($key, 'throughput'); } /** * Get the average runtime for a given job in milliseconds. * * @param string $job * @return float */ public function runtimeForJob($job) { return $this->runtimeFor('job:'.$job); } /** * Get the average runtime for a given queue in milliseconds. * * @param string $queue * @return float */ public function runtimeForQueue($queue) { return $this->runtimeFor('queue:'.$queue); } /** * Get the average runtime for a given key in milliseconds. * * @param string $key * @return float */ protected function runtimeFor($key) { return (float) $this->connection()->hget($key, 'runtime'); } /** * Get the queue that has the longest runtime. * * @return int */ public function queueWithMaximumRuntime() { return collect($this->measuredQueues())->sortBy(function ($queue) { if ($snapshots = $this->connection()->zrange('snapshot:queue:'.$queue, -1, 1)) { return json_decode($snapshots[0])->runtime; } })->last(); } /** * Get the queue that has the most throughput. * * @return int */ public function queueWithMaximumThroughput() { return collect($this->measuredQueues())->sortBy(function ($queue) { if ($snapshots = $this->connection()->zrange('snapshot:queue:'.$queue, -1, 1)) { return json_decode($snapshots[0])->throughput; } })->last(); } /** * Increment the metrics information for a job. * * @param string $job * @param float|null $runtime * @return void */ public function incrementJob($job, $runtime) { $this->connection()->eval(LuaScripts::updateMetrics(), 2, 'job:'.$job, 'measured_jobs', str_replace(',', '.', (string) $runtime) ); } /** * Increment the metrics information for a queue. * * @param string $queue * @param float|null $runtime * @return void */ public function incrementQueue($queue, $runtime) { $this->connection()->eval(LuaScripts::updateMetrics(), 2, 'queue:'.$queue, 'measured_queues', str_replace(',', '.', (string) $runtime) ); } /** * Get all of the snapshots for the given job. * * @param string $job * @return array */ public function snapshotsForJob($job) { return $this->snapshotsFor('job:'.$job); } /** * Get all of the snapshots for the given queue. * * @param string $queue * @return array */ public function snapshotsForQueue($queue) { return $this->snapshotsFor('queue:'.$queue); } /** * Get all of the snapshots for the given key. * * @param string $key * @return array */ protected function snapshotsFor($key) { return collect($this->connection()->zrange('snapshot:'.$key, 0, -1)) ->map(function ($snapshot) { return (object) json_decode($snapshot, true); })->values()->all(); } /** * Store a snapshot of the metrics information. * * @return void */ public function snapshot() { collect($this->measuredJobs())->each(function ($job) { $this->storeSnapshotForJob($job); }); collect($this->measuredQueues())->each(function ($queue) { $this->storeSnapshotForQueue($queue); }); $this->storeSnapshotTimestamp(); } /** * Store a snapshot for the given job. * * @param string $job * @return void */ protected function storeSnapshotForJob($job) { $data = $this->baseSnapshotData($key = 'job:'.$job); $this->connection()->zadd( 'snapshot:'.$key, $time = CarbonImmutable::now()->getTimestamp(), json_encode([ 'throughput' => $data['throughput'], 'runtime' => $data['runtime'], 'time' => $time, ]) ); $this->connection()->zremrangebyrank( 'snapshot:'.$key, 0, -abs(1 + config('horizon.metrics.trim_snapshots.job', 24)) ); } /** * Store a snapshot for the given queue. * * @param string $queue * @return void */ protected function storeSnapshotForQueue($queue) { $data = $this->baseSnapshotData($key = 'queue:'.$queue); $this->connection()->zadd( 'snapshot:'.$key, $time = CarbonImmutable::now()->getTimestamp(), json_encode([ 'throughput' => $data['throughput'], 'runtime' => $data['runtime'], 'wait' => app(WaitTimeCalculator::class)->calculateFor($queue), 'time' => $time, ]) ); $this->connection()->zremrangebyrank( 'snapshot:'.$key, 0, -abs(1 + config('horizon.metrics.trim_snapshots.queue', 24)) ); } /** * Get the base snapshot data for a given key. * * @param string $key * @return array */ protected function baseSnapshotData($key) { $responses = $this->connection()->transaction(function ($trans) use ($key) { $trans->hmget($key, ['throughput', 'runtime']); $trans->del($key); }); $snapshot = array_values($responses[0]); return [ 'throughput' => $snapshot[0], 'runtime' => $snapshot[1], ]; } /** * Get the number of minutes passed since the last snapshot. * * @return float */ protected function minutesSinceLastSnapshot() { $lastSnapshotAt = (int) ($this->connection()->get('last_snapshot_at') ?: $this->storeSnapshotTimestamp()); return max( (CarbonImmutable::now()->getTimestamp() - $lastSnapshotAt) / 60, 1 ); } /** * Store the current timestamp as the "last snapshot timestamp". * * @return int */ protected function storeSnapshotTimestamp() { return tap(CarbonImmutable::now()->getTimestamp(), function ($timestamp) { $this->connection()->set('last_snapshot_at', $timestamp); }); } /** * Attempt to acquire a lock to monitor the queue wait times. * * @return bool */ public function acquireWaitTimeMonitorLock() { return app(Lock::class)->get('monitor:time-to-clear'); } /** * Clear the metrics for a key. * * @param string $key * @return void */ public function forget($key) { $this->connection()->del($key); } /** * Delete all stored metrics information. * * @return void */ public function clear() { $this->forget('last_snapshot_at'); $this->forget('measured_jobs'); $this->forget('measured_queues'); $this->forget('metrics:snapshot'); foreach (['queue:*', 'job:*', 'snapshot:*'] as $pattern) { $cursor = null; do { [$cursor, $keys] = $this->connection()->scan( $cursor, ['match' => config('horizon.prefix').$pattern] ); foreach ($keys ?? [] as $key) { $this->forget(Str::after($key, config('horizon.prefix'))); } } while ($cursor > 0); } } /** * Get the Redis connection instance. * * @return \Illuminate\Redis\Connections\Connection */ public function connection() { return $this->redis->connection('horizon'); } } PK ! R�9�Q Q HorizonServiceProvider.phpnu ȯ�� <?php namespace Laravel\Horizon; use Illuminate\Contracts\Events\Dispatcher; use Illuminate\Contracts\Foundation\CachesRoutes; use Illuminate\Queue\QueueManager; use Illuminate\Support\Facades\Route; use Illuminate\Support\ServiceProvider; use Laravel\Horizon\Connectors\RedisConnector; class HorizonServiceProvider extends ServiceProvider { use EventMap, ServiceBindings; /** * Bootstrap any application services. * * @return void */ public function boot() { $this->registerEvents(); $this->registerRoutes(); $this->registerResources(); $this->offerPublishing(); $this->registerCommands(); } /** * Register the Horizon job events. * * @return void */ protected function registerEvents() { $events = $this->app->make(Dispatcher::class); foreach ($this->events as $event => $listeners) { foreach ($listeners as $listener) { $events->listen($event, $listener); } } } /** * Register the Horizon routes. * * @return void */ protected function registerRoutes() { if ($this->app instanceof CachesRoutes && $this->app->routesAreCached()) { return; } Route::group([ 'domain' => config('horizon.domain', null), 'prefix' => config('horizon.path'), 'namespace' => 'Laravel\Horizon\Http\Controllers', 'middleware' => config('horizon.middleware', 'web'), ], function () { $this->loadRoutesFrom(__DIR__.'/../routes/web.php'); }); } /** * Register the Horizon resources. * * @return void */ protected function registerResources() { $this->loadViewsFrom(__DIR__.'/../resources/views', 'horizon'); } /** * Setup the resource publishing groups for Horizon. * * @return void */ protected function offerPublishing() { if ($this->app->runningInConsole()) { $this->publishes([ __DIR__.'/../stubs/HorizonServiceProvider.stub' => app_path('Providers/HorizonServiceProvider.php'), ], 'horizon-provider'); $this->publishes([ __DIR__.'/../config/horizon.php' => config_path('horizon.php'), ], 'horizon-config'); } } /** * Register the Horizon Artisan commands. * * @return void */ protected function registerCommands() { if ($this->app->runningInConsole()) { $this->commands([ Console\ClearCommand::class, Console\ClearMetricsCommand::class, Console\ContinueCommand::class, Console\ContinueSupervisorCommand::class, Console\ForgetFailedCommand::class, Console\HorizonCommand::class, Console\InstallCommand::class, Console\ListCommand::class, Console\PauseCommand::class, Console\PauseSupervisorCommand::class, Console\PublishCommand::class, Console\PurgeCommand::class, Console\StatusCommand::class, Console\SupervisorCommand::class, Console\SupervisorStatusCommand::class, Console\SupervisorsCommand::class, Console\TerminateCommand::class, Console\TimeoutCommand::class, Console\WorkCommand::class, ]); } $this->commands([Console\SnapshotCommand::class]); } /** * Register any application services. * * @return void */ public function register() { if (! defined('HORIZON_PATH')) { define('HORIZON_PATH', realpath(__DIR__.'/../')); } $this->app->bind(Console\WorkCommand::class, function ($app) { return new Console\WorkCommand($app['queue.worker'], $app['cache.store']); }); $this->configure(); $this->registerServices(); $this->registerQueueConnectors(); } /** * Setup the configuration for Horizon. * * @return void */ protected function configure() { $this->mergeConfigFrom( __DIR__.'/../config/horizon.php', 'horizon' ); Horizon::use(config('horizon.use', 'default')); } /** * Register Horizon's services in the container. * * @return void */ protected function registerServices() { foreach ($this->serviceBindings as $key => $value) { is_numeric($key) ? $this->app->singleton($value) : $this->app->singleton($key, $value); } } /** * Register the custom queue connectors for Horizon. * * @return void */ protected function registerQueueConnectors() { $this->callAfterResolving(QueueManager::class, function ($manager) { $manager->addConnector('redis', function () { return new RedisConnector($this->app['redis']); }); }); } } PK ! }��h7 7 + Listeners/MonitorMasterSupervisorMemory.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Events\MasterSupervisorLooped; use Laravel\Horizon\Events\MasterSupervisorOutOfMemory; class MonitorMasterSupervisorMemory { /** * Handle the event. * * @param \Laravel\Horizon\Events\MasterSupervisorLooped $event * @return void */ public function handle(MasterSupervisorLooped $event) { $master = $event->master; $memoryLimit = config('horizon.memory_limit', 64); if ($master->memoryUsage() > $memoryLimit) { event(new MasterSupervisorOutOfMemory($master)); $master->output('error', 'Memory limit exceeded: Using '.ceil($master->memoryUsage()).'/'.$memoryLimit.'MB. Consider increasing horizon.memory_limit.'); $master->terminate(12); } } } PK ! �?6 6 Listeners/ExpireSupervisors.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Contracts\MasterSupervisorRepository; use Laravel\Horizon\Contracts\SupervisorRepository; use Laravel\Horizon\Events\MasterSupervisorLooped; class ExpireSupervisors { /** * Handle the event. * * @param \Laravel\Horizon\Events\MasterSupervisorLooped $event * @return void */ public function handle(MasterSupervisorLooped $event) { app(MasterSupervisorRepository::class)->flushExpired(); app(SupervisorRepository::class)->flushExpired(); } } PK ! �*��| | ' Listeners/PruneTerminatingProcesses.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Events\SupervisorLooped; class PruneTerminatingProcesses { /** * Handle the event. * * @param \Laravel\Horizon\Events\SupervisorLooped $event * @return void */ public function handle(SupervisorLooped $event) { $event->supervisor->pruneTerminatingProcesses(); } } PK ! �2�) ) Listeners/MarkJobAsReserved.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Events\JobReserved; class MarkJobAsReserved { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * Create a new listener instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @return void */ public function __construct(JobRepository $jobs) { $this->jobs = $jobs; } /** * Handle the event. * * @param \Laravel\Horizon\Events\JobReserved $event * @return void */ public function handle(JobReserved $event) { $this->jobs->reserved($event->connectionName, $event->queue, $event->payload); } } PK ! ���T T Listeners/MarkJobAsFailed.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Events\JobFailed; class MarkJobAsFailed { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * Create a new listener instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @return void */ public function __construct(JobRepository $jobs) { $this->jobs = $jobs; } /** * Handle the event. * * @param \Laravel\Horizon\Events\JobFailed $event * @return void */ public function handle(JobFailed $event) { $this->jobs->failed( $event->exception, $event->connectionName, $event->queue, $event->payload ); } } PK ! ��*u u Listeners/MonitorWaitTimes.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Carbon\CarbonImmutable; use Laravel\Horizon\Contracts\MetricsRepository; use Laravel\Horizon\Events\LongWaitDetected; use Laravel\Horizon\WaitTimeCalculator; class MonitorWaitTimes { /** * The metrics repository implementation. * * @var \Laravel\Horizon\Contracts\MetricsRepository */ public $metrics; /** * The time at which we last checked if monitoring was due. * * @var \Carbon\CarbonImmutable */ public $lastMonitored; /** * Create a new listener instance. * * @param \Laravel\Horizon\Contracts\MetricsRepository $metrics * @return void */ public function __construct(MetricsRepository $metrics) { $this->metrics = $metrics; } /** * Handle the event. * * @param \Laravel\Horizon\Events\SupervisorLooped $event * @return void */ public function handle() { if (! $this->dueToMonitor()) { return; } // Here we will calculate the wait time in seconds for each of the queues that // the application is working. Then, we will filter the results to find the // queues with the longest wait times and raise events for each of these. $results = app(WaitTimeCalculator::class)->calculate(); $long = collect($results)->filter(function ($wait, $queue) { return config("horizon.waits.{$queue}") !== 0 && $wait > (config("horizon.waits.{$queue}") ?? 60); }); // Once we have determined which queues have long wait times we will raise the // events for each of the queues. We'll need to separate the connection and // queue names into their own strings before we will fire off the events. $long->each(function ($wait, $queue) { [$connection, $queue] = explode(':', $queue, 2); event(new LongWaitDetected($connection, $queue, $wait)); }); } /** * Determine if monitoring is due. * * @return bool */ protected function dueToMonitor() { // We will keep track of the amount of time between attempting to acquire the // lock to monitor the wait times. We only want a single supervisor to run // the checks on a given interval so that we don't fire too many events. if (! $this->lastMonitored) { $this->lastMonitored = CarbonImmutable::now(); } if (! $this->timeToMonitor()) { return false; } // Next we will update the monitor timestamp and attempt to acquire a lock to // check the wait times. We use Redis to do it in order to have the atomic // operation required. This will avoid any deadlocks or race conditions. $this->lastMonitored = CarbonImmutable::now(); return $this->metrics->acquireWaitTimeMonitorLock(); } /** * Determine if enough time has elapsed to attempt to monitor. * * @return bool */ protected function timeToMonitor() { return CarbonImmutable::now()->subMinutes(1)->lte($this->lastMonitored); } } PK ! � � � Listeners/TrimMonitoredJobs.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Carbon\CarbonImmutable; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Events\MasterSupervisorLooped; class TrimMonitoredJobs { /** * The last time the monitored jobs were trimmed. * * @var \Carbon\CarbonImmutable */ public $lastTrimmed; /** * How many minutes to wait in between each trim. * * @var int */ public $frequency = 1440; /** * Handle the event. * * @param \Laravel\Horizon\Events\MasterSupervisorLooped $event * @return void */ public function handle(MasterSupervisorLooped $event) { if (! isset($this->lastTrimmed)) { $this->frequency = max(1, intdiv( config('horizon.trim.monitored', 10080), 12 )); $this->lastTrimmed = CarbonImmutable::now()->subMinutes($this->frequency + 1); } if ($this->lastTrimmed->lte(CarbonImmutable::now()->subMinutes($this->frequency))) { app(JobRepository::class)->trimMonitoredJobs(); $this->lastTrimmed = CarbonImmutable::now(); } } } PK ! V���� � Listeners/TrimRecentJobs.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Carbon\CarbonImmutable; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Events\MasterSupervisorLooped; class TrimRecentJobs { /** * The last time the recent jobs were trimmed. * * @var \Carbon\CarbonImmutable */ public $lastTrimmed; /** * How many minutes to wait in between each trim. * * @var int */ public $frequency = 1; /** * Handle the event. * * @param \Laravel\Horizon\Events\MasterSupervisorLooped $event * @return void */ public function handle(MasterSupervisorLooped $event) { if (! isset($this->lastTrimmed)) { $this->lastTrimmed = CarbonImmutable::now()->subMinutes($this->frequency + 1); } if ($this->lastTrimmed->lte(CarbonImmutable::now()->subMinutes($this->frequency))) { app(JobRepository::class)->trimRecentJobs(); $this->lastTrimmed = CarbonImmutable::now(); } } } PK ! �6�*U U Listeners/MarshalFailedEvent.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Illuminate\Contracts\Events\Dispatcher; use Illuminate\Queue\Events\JobFailed as LaravelJobFailed; use Illuminate\Queue\Jobs\RedisJob; use Laravel\Horizon\Events\JobFailed; class MarshalFailedEvent { /** * The event dispatcher implementation. * * @var \Illuminate\Contracts\Events\Dispatcher */ public $events; /** * Create a new listener instance. * * @param \Illuminate\Contracts\Events\Dispatcher $events * @return void */ public function __construct(Dispatcher $events) { $this->events = $events; } /** * Handle the event. * * @param \Illuminate\Queue\Events\JobFailed $event * @return void */ public function handle(LaravelJobFailed $event) { if (! $event->job instanceof RedisJob) { return; } $this->events->dispatch((new JobFailed( $event->exception, $event->job, $event->job->getReservedJob() ))->connection($event->connectionName)->queue($event->job->getQueue())); } } PK ! ߿�� � Listeners/StartTimingJob.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Events\JobReserved; use Laravel\Horizon\Stopwatch; class StartTimingJob { /** * The stopwatch instance. * * @var \Laravel\Horizon\Stopwatch */ public $watch; /** * Create a new listener instance. * * @param \Laravel\Horizon\Stopwatch $watch * @return void */ public function __construct(Stopwatch $watch) { $this->watch = $watch; } /** * Handle the event. * * @param \Laravel\Horizon\Events\JobReserved $event * @return void */ public function handle(JobReserved $event) { $this->watch->start($event->payload->id()); } } PK ! E��� � Listeners/StoreMonitoredTags.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Contracts\TagRepository; use Laravel\Horizon\Events\JobPushed; class StoreMonitoredTags { /** * The tag repository implementation. * * @var \Laravel\Horizon\Contracts\TagRepository */ public $tags; /** * Create a new listener instance. * * @param \Laravel\Horizon\Contracts\TagRepository $tags * @return void */ public function __construct(TagRepository $tags) { $this->tags = $tags; } /** * Handle the event. * * @param \Laravel\Horizon\Events\JobPushed $event * @return void */ public function handle(JobPushed $event) { $monitoring = $this->tags->monitored($event->payload->tags()); if (! empty($monitoring)) { $this->tags->add($event->payload->id(), $monitoring); } } } PK ! '���) ) Listeners/MarkJobAsReleased.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Events\JobReleased; class MarkJobAsReleased { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * Create a new listener instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @return void */ public function __construct(JobRepository $jobs) { $this->jobs = $jobs; } /** * Handle the event. * * @param \Laravel\Horizon\Events\JobReleased $event * @return void */ public function handle(JobReleased $event) { $this->jobs->released($event->connectionName, $event->queue, $event->payload); } } PK ! �>U U % Listeners/MonitorSupervisorMemory.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Events\SupervisorLooped; use Laravel\Horizon\Events\SupervisorOutOfMemory; class MonitorSupervisorMemory { /** * Handle the event. * * @param \Laravel\Horizon\Events\SupervisorLooped $event * @return void */ public function handle(SupervisorLooped $event) { $supervisor = $event->supervisor; if ($supervisor->memoryUsage() > $supervisor->options->memory) { event(new SupervisorOutOfMemory($supervisor)); $supervisor->terminate(12); } } } PK ! 6�� � Listeners/ForgetJobTimer.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Stopwatch; class ForgetJobTimer { /** * The stopwatch instance. * * @var \Laravel\Horizon\Stopwatch */ public $watch; /** * Create a new listener instance. * * @param \Laravel\Horizon\Stopwatch $watch * @return void */ public function __construct(Stopwatch $watch) { $this->watch = $watch; } /** * Handle the event. * * @param \Illuminate\Queue\Events\JobExceptionOccurred|\Illuminate\Queue\Events\JobFailed $event * @return void */ public function handle($event) { $this->watch->forget($event->job->getJobId()); } } PK ! ��p�i i Listeners/UpdateJobMetrics.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Contracts\MetricsRepository; use Laravel\Horizon\Events\JobDeleted; use Laravel\Horizon\Stopwatch; class UpdateJobMetrics { /** * The metrics repository implementation. * * @var \Laravel\Horizon\Contracts\MetricsRepository */ public $metrics; /** * The stopwatch instance. * * @var \Laravel\Horizon\Stopwatch */ public $watch; /** * Create a new listener instance. * * @param \Laravel\Horizon\Contracts\MetricsRepository $metrics * @param \Laravel\Horizon\Stopwatch $watch * @return void */ public function __construct(MetricsRepository $metrics, Stopwatch $watch) { $this->watch = $watch; $this->metrics = $metrics; } /** * Stop gathering metrics for a job. * * @param \Laravel\Horizon\Events\JobDeleted $event * @return void */ public function handle(JobDeleted $event) { if ($event->job->hasFailed()) { return; } $time = $this->watch->check($id = $event->payload->id()) ?: 0; $this->metrics->incrementQueue( $event->job->getQueue(), $time ); $this->metrics->incrementJob( $event->payload->displayName(), $time ); $this->watch->forget($id); } } PK ! Y�1�� � Listeners/SendNotification.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Illuminate\Support\Facades\Notification; use Laravel\Horizon\Horizon; use Laravel\Horizon\Lock; class SendNotification { /** * Handle the event. * * @param mixed $event * @return void */ public function handle($event) { $notification = $event->toNotification(); if (! app(Lock::class)->get('notification:'.$notification->signature(), 300)) { return; } Notification::route('slack', Horizon::$slackWebhookUrl) ->route('nexmo', Horizon::$smsNumber) ->route('mail', Horizon::$email) ->notify($notification); } } PK ! R� &. . Listeners/StoreJob.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Events\JobPushed; class StoreJob { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * Create a new listener instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @return void */ public function __construct(JobRepository $jobs) { $this->jobs = $jobs; } /** * Handle the event. * * @param \Laravel\Horizon\Events\JobPushed $event * @return void */ public function handle(JobPushed $event) { $this->jobs->pushed( $event->connectionName, $event->queue, $event->payload ); } } PK ! ���]. . Listeners/MarkJobAsComplete.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Contracts\TagRepository; use Laravel\Horizon\Events\JobDeleted; class MarkJobAsComplete { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * The tag repository implementation. * * @var \Laravel\Horizon\Contracts\TagRepository */ public $tags; /** * Create a new listener instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @param \Laravel\Horizon\Contracts\TagRepository $tags * @return void */ public function __construct(JobRepository $jobs, TagRepository $tags) { $this->jobs = $jobs; $this->tags = $tags; } /** * Handle the event. * * @param \Laravel\Horizon\Events\JobDeleted $event * @return void */ public function handle(JobDeleted $event) { $this->jobs->completed($event->payload, $event->job->hasFailed(), $event->payload->isSilenced()); if (! $event->job->hasFailed() && count($this->tags->monitored($event->payload->tags())) > 0) { $this->jobs->remember($event->connectionName, $event->queue, $event->payload); } } } PK ! �v�Q. . Listeners/MarkJobsAsMigrated.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Events\JobsMigrated; class MarkJobsAsMigrated { /** * The job repository implementation. * * @var \Laravel\Horizon\Contracts\JobRepository */ public $jobs; /** * Create a new listener instance. * * @param \Laravel\Horizon\Contracts\JobRepository $jobs * @return void */ public function __construct(JobRepository $jobs) { $this->jobs = $jobs; } /** * Handle the event. * * @param \Laravel\Horizon\Events\JobsMigrated $event * @return void */ public function handle(JobsMigrated $event) { $this->jobs->migrated($event->connectionName, $event->queue, $event->payloads); } } PK ! � �=z z Listeners/TrimFailedJobs.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Carbon\CarbonImmutable; use Laravel\Horizon\Contracts\JobRepository; use Laravel\Horizon\Events\MasterSupervisorLooped; class TrimFailedJobs { /** * The last time the recent jobs were trimmed. * * @var \Carbon\CarbonImmutable */ public $lastTrimmed; /** * How many minutes to wait in between each trim. * * @var int */ public $frequency = 5040; /** * Handle the event. * * @param \Laravel\Horizon\Events\MasterSupervisorLooped $event * @return void */ public function handle(MasterSupervisorLooped $event) { if (! isset($this->lastTrimmed)) { $this->frequency = max(1, intdiv( config('horizon.trim.failed', 10080), 12 )); $this->lastTrimmed = CarbonImmutable::now()->subMinutes($this->frequency + 1); } if ($this->lastTrimmed->lte(CarbonImmutable::now()->subMinutes($this->frequency))) { app(JobRepository::class)->trimFailedJobs(); $this->lastTrimmed = CarbonImmutable::now(); } } } PK ! ��*� � # Listeners/StoreTagsForFailedJob.phpnu ȯ�� <?php namespace Laravel\Horizon\Listeners; use Laravel\Horizon\Contracts\TagRepository; use Laravel\Horizon\Events\JobFailed; class StoreTagsForFailedJob { /** * The tag repository implementation. * * @var \Laravel\Horizon\Contracts\TagRepository */ public $tags; /** * Create a new listener instance. * * @param \Laravel\Horizon\Contracts\TagRepository $tags * @return void */ public function __construct(TagRepository $tags) { $this->tags = $tags; } /** * Handle the event. * * @param \Laravel\Horizon\Events\JobFailed $event * @return void */ public function handle(JobFailed $event) { $tags = collect($event->payload->tags())->map(function ($tag) { return 'failed:'.$tag; })->all(); $this->tags->addTemporary( config('horizon.trim.failed', 2880), $event->payload->id(), $tags ); } } PK ! DպRN N Stopwatch.phpnu ȯ�� <?php namespace Laravel\Horizon; class Stopwatch { /** * All of the current timers. * * @var array */ public $timers = []; /** * Start a new timer. * * @param string $key * @return void */ public function start($key) { $this->timers[$key] = microtime(true); } /** * Check a given timer and get the elapsed time in milliseconds. * * @param string $key * @return float|null */ public function check($key) { if (isset($this->timers[$key])) { return round((microtime(true) - $this->timers[$key]) * 1000, 2); } } /** * Forget a given timer. * * @param string $key * @return void */ public function forget($key) { unset($this->timers[$key]); } } PK ! ��e e WorkerProcess.phpnu ȯ�� <?php namespace Laravel\Horizon; use Carbon\CarbonImmutable; use Closure; use Laravel\Horizon\Events\UnableToLaunchProcess; use Laravel\Horizon\Events\WorkerProcessRestarting; use Symfony\Component\Process\Exception\ExceptionInterface; class WorkerProcess { /** * The underlying Symfony process. * * @var \Symfony\Component\Process\Process */ public $process; /** * The output handler callback. * * @var \Closure */ public $output; /** * The time at which the cooldown period will be over. * * @var \Carbon\CarbonImmutable */ public $restartAgainAt; /** * Create a new worker process instance. * * @param \Symfony\Component\Process\Process $process * @return void */ public function __construct($process) { $this->process = $process; } /** * Start the process. * * @param \Closure $callback * @return $this */ public function start(Closure $callback) { $this->output = $callback; $this->cooldown(); $this->process->start($callback); return $this; } /** * Pause the worker process. * * @return void */ public function pause() { $this->sendSignal(SIGUSR2); } /** * Instruct the worker process to continue working. * * @return void */ public function continue() { $this->sendSignal(SIGCONT); } /** * Evaluate the current state of the process. * * @return void */ public function monitor() { if ($this->process->isRunning() || $this->coolingDown()) { return; } $this->restart(); } /** * Restart the process. * * @return void */ protected function restart() { if ($this->process->isStarted()) { event(new WorkerProcessRestarting($this)); } $this->start($this->output); } /** * Terminate the underlying process. * * @return void */ public function terminate() { $this->sendSignal(SIGTERM); } /** * Stop the underlying process. * * @return void */ public function stop() { if ($this->process->isRunning()) { $this->process->stop(); } } /** * Send a POSIX signal to the process. * * @param int $signal * @return void */ protected function sendSignal($signal) { try { $this->process->signal($signal); } catch (ExceptionInterface $e) { if ($this->process->isRunning()) { throw $e; } } } /** * Begin the cool-down period for the process. * * @return void */ protected function cooldown() { if ($this->coolingDown()) { return; } if ($this->restartAgainAt) { $this->restartAgainAt = ! $this->process->isRunning() ? CarbonImmutable::now()->addMinute() : null; if (! $this->process->isRunning()) { event(new UnableToLaunchProcess($this)); } } else { $this->restartAgainAt = CarbonImmutable::now()->addSecond(); } } /** * Determine if the process is cooling down from a failed restart. * * @return bool */ public function coolingDown() { return isset($this->restartAgainAt) && CarbonImmutable::now()->lt($this->restartAgainAt); } /** * Set the output handler. * * @param \Closure $callback * @return $this */ public function handleOutputUsing(Closure $callback) { $this->output = $callback; return $this; } /** * Pass on method calls to the underlying process. * * @param string $method * @param array $parameters * @return mixed */ public function __call($method, $parameters) { return $this->process->{$method}(...$parameters); } } PK ! �����! �! SupervisorOptions.phpnu ȯ�� <?php namespace Laravel\Horizon; class SupervisorOptions { /** * The name of the supervisor. * * @var string */ public $name; /** * The name of the workers. * * @var string */ public $workersName; /** * The queue connection that should be utilized. * * @var string */ public $connection; /** * The queue that should be utilized. * * @var string */ public $queue; /** * Indicates the balancing strategy the supervisor should use. * * @var bool */ public $balance = 'off'; /** * Indicates whether auto-scaling strategy should use "time" (time-to-complete) or "size" (total count of jobs) strategies. * * @var string|null */ public $autoScalingStrategy = null; /** * Indicates if the supervisor should auto-scale. * * @var bool */ public $autoScale; /** * The maximum number of total processes to start when auto-scaling. * * @var int */ public $maxProcesses = 1; /** * The minimum number of processes to assign per working when auto-scaling. * * @var int */ public $minProcesses = 1; /** * The parent process identifier. * * @var int */ public $parentId = 0; /** * The process priority. * * @var int */ public $nice = 0; /** * The working directories that new workers should be started from. * * @var string */ public $directory; /** * The number of seconds to wait in between auto-scaling attempts. * * @var int */ public $balanceCooldown = 3; /** * The maximum number of processes to increase or decrease per one scaling. * * @var int */ public $balanceMaxShift = 1; /** * The number of seconds to wait before retrying a job that encountered an uncaught exception. * * @var int */ public $backoff; /** * The maximum number of jobs to run. * * @var int */ public $maxJobs; /** * The maximum number of seconds a worker may live. * * @var int */ public $maxTime; /** * The maximum amount of RAM the worker may consume. * * @var int */ public $memory; /** * The maximum number of seconds a child worker may run. * * @var int */ public $timeout; /** * The number of seconds to wait in between polling the queue. * * @var int */ public $sleep; /** * The maximum amount of times a job may be attempted. * * @var int */ public $maxTries; /** * Indicates if the worker should run in maintenance mode. * * @var bool */ public $force; /** * The number of seconds to rest between jobs. * * @var int */ public $rest; /** * Create a new worker options instance. * * @param string $name * @param string $connection * @param string $queue * @param string $workersName * @param string $balance * @param int $backoff * @param int $maxTime * @param int $maxJobs * @param int $maxProcesses * @param int $minProcesses * @param int $memory * @param int $timeout * @param int $sleep * @param int $maxTries * @param bool $force * @param int $nice * @param int $balanceCooldown * @param int $balanceMaxShift * @param int $parentId * @param int $rest * @param string|null $autoScalingStrategy */ public function __construct($name, $connection, $queue = null, $workersName = 'default', $balance = 'off', $backoff = 0, $maxTime = 0, $maxJobs = 0, $maxProcesses = 1, $minProcesses = 1, $memory = 128, $timeout = 60, $sleep = 3, $maxTries = 0, $force = false, $nice = 0, $balanceCooldown = 3, $balanceMaxShift = 1, $parentId = 0, $rest = 0, $autoScalingStrategy = 'time' ) { $this->name = $name; $this->connection = $connection; $this->queue = $queue ?: config('queue.connections.'.$connection.'.queue'); $this->workersName = $workersName; $this->balance = $balance; $this->backoff = $backoff; $this->maxTime = $maxTime; $this->maxJobs = $maxJobs; $this->maxProcesses = $maxProcesses; $this->minProcesses = $minProcesses; $this->memory = $memory; $this->timeout = $timeout; $this->sleep = $sleep; $this->maxTries = $maxTries; $this->force = $force; $this->nice = $nice; $this->balanceCooldown = $balanceCooldown; $this->balanceMaxShift = $balanceMaxShift; $this->parentId = $parentId; $this->rest = $rest; $this->autoScalingStrategy = $autoScalingStrategy; } /** * Create a fresh options instance with the given queue. * * @param string $queue * @return static */ public function withQueue($queue) { return tap(clone $this, function ($options) use ($queue) { $options->queue = $queue; }); } /** * Determine if a balancing strategy should be used. * * @return bool */ public function balancing() { return in_array($this->balance, ['simple', 'auto']); } /** * Determine if auto-scaling should be applied. * * @return bool */ public function autoScaling() { return $this->balance !== 'simple'; } /** * Determine if auto-scaling should be based on the number of jobs on the queue instead of time-to-clear. * * @return bool */ public function autoScaleByNumberOfJobs() { return $this->autoScalingStrategy === 'size'; } /** * Get the command-line representation of the options for a supervisor. * * @return string */ public function toSupervisorCommand() { return SupervisorCommandString::fromOptions($this); } /** * Get the command-line representation of the options for a worker. * * @return string */ public function toWorkerCommand() { return WorkerCommandString::fromOptions($this); } /** * Convert the options to a JSON string. * * @return string */ public function toJson() { return json_encode($this->toArray()); } /** * Convert the options to a raw array. * * @return array */ public function toArray() { return [ 'balance' => $this->balance, 'connection' => $this->connection, 'queue' => $this->queue, 'backoff' => $this->backoff, 'force' => $this->force, 'maxProcesses' => $this->maxProcesses, 'minProcesses' => $this->minProcesses, 'maxTries' => $this->maxTries, 'maxTime' => $this->maxTime, 'maxJobs' => $this->maxJobs, 'memory' => $this->memory, 'nice' => $this->nice, 'name' => $this->name, 'workersName' => $this->workersName, 'sleep' => $this->sleep, 'timeout' => $this->timeout, 'balanceCooldown' => $this->balanceCooldown, 'balanceMaxShift' => $this->balanceMaxShift, 'parentId' => $this->parentId, 'rest' => $this->rest, 'autoScalingStrategy' => $this->autoScalingStrategy, ]; } /** * Create a new options instance from the given array. * * @param array $array * @return static */ public static function fromArray(array $array) { return tap(new static($array['name'], $array['connection']), function ($options) use ($array) { foreach ($array as $key => $value) { $options->{$key} = $value; } }); } } PK ! {�u�6 6 * MasterSupervisorCommands/AddSupervisor.phpnu ȯ�� <?php namespace Laravel\Horizon\MasterSupervisorCommands; use Laravel\Horizon\MasterSupervisor; use Laravel\Horizon\SupervisorOptions; use Laravel\Horizon\SupervisorProcess; use Symfony\Component\Process\Process; class AddSupervisor { /** * Process the command. * * @param \Laravel\Horizon\MasterSupervisor $master * @param array $options * @return void */ public function process(MasterSupervisor $master, array $options) { $options = SupervisorOptions::fromArray($options); $master->supervisors[] = new SupervisorProcess( $options, $this->createProcess($master, $options), function ($type, $line) use ($master) { $master->output($type, $line); } ); } /** * Create the Symfony process instance. * * @param \Laravel\Horizon\MasterSupervisor $master * @param \Laravel\Horizon\SupervisorOptions $options * @return \Symfony\Component\Process\Process */ protected function createProcess(MasterSupervisor $master, SupervisorOptions $options) { $command = $options->toSupervisorCommand(); return Process::fromShellCommandline($command, $options->directory ?? base_path()) ->setTimeout(null) ->disableOutput(); } } PK ! ���P Exec.phpnu ȯ�� <?php namespace Laravel\Horizon; class Exec { /** * Run the given command. * * @param string $command * @return array */ public function run($command) { exec($command, $output); return $output; } } PK ! .���P P SupervisorFactory.phpnu ȯ�� <?php namespace Laravel\Horizon; class SupervisorFactory { /** * Create a new supervisor instance. * * @param \Laravel\Horizon\SupervisorOptions $options * @return \Laravel\Horizon\Supervisor */ public function make(SupervisorOptions $options) { return new Supervisor($options); } } PK ! ^ `� � LuaScripts.phpnu ȯ�� <?php namespace Laravel\Horizon; class LuaScripts { /** * Update the metrics for a job. * * KEYS[1] - The name of the key being updated * KEYS[2] - The name of the key of the metrics group * ARGV[1] - The runtime in milliseconds of the current job * * @return string */ public static function updateMetrics() { return <<<'LUA' redis.call('hsetnx', KEYS[1], 'throughput', 0) redis.call('sadd', KEYS[2], KEYS[1]) local hash = redis.call('hmget', KEYS[1], 'throughput', 'runtime') local throughput = hash[1] + 1 local runtime = 0 if hash[2] then runtime = ((hash[1] * tonumber(hash[2])) + tonumber(ARGV[1])) / throughput else runtime = tonumber(ARGV[1]) end redis.call('hmset', KEYS[1], 'throughput', throughput, 'runtime', runtime) LUA; } /** * Get the Lua script for purging recent and pending jobs off of the queue. * * KEYS[1] - The name of the recent jobs sorted set * KEYS[2] - The name of the pending jobs sorted set * ARGV[1] - The prefix of the Horizon keys * ARGV[2] - The name of the queue to purge * * @return string */ public static function purge() { return <<<'LUA' local count = 0 local cursor = 0 repeat -- Iterate over the recent jobs sorted set local scanner = redis.call('zscan', KEYS[1], cursor) cursor = scanner[1] for i = 1, #scanner[2], 2 do local jobid = scanner[2][i] local hashkey = ARGV[1] .. jobid local job = redis.call('hmget', hashkey, 'status', 'queue') -- Delete the pending/reserved jobs, that match the queue -- name, from the sorted sets as well as the job hash if((job[1] == 'reserved' or job[1] == 'pending') and job[2] == ARGV[2]) then redis.call('zrem', KEYS[1], jobid) redis.call('zrem', KEYS[2], jobid) redis.call('del', hashkey) count = count + 1 end end until cursor == '0' return count LUA; } } PK ! ��](� � Lock.phpnu ȯ�� <?php namespace Laravel\Horizon; use Illuminate\Contracts\Redis\Factory as RedisFactory; class Lock { /** * The Redis factory implementation. * * @var \Illuminate\Contracts\Redis\Factory */ public $redis; /** * Create a Horizon lock manager. * * @param \Illuminate\Contracts\Redis\Factory $redis * @return void */ public function __construct(RedisFactory $redis) { $this->redis = $redis; } /** * Execute the given callback if a lock can be acquired. * * @param string $key * @param \Closure $callback * @param int $seconds * @return void */ public function with($key, $callback, $seconds = 60) { if ($this->get($key, $seconds)) { try { call_user_func($callback); } finally { $this->release($key); } } } /** * Determine if a lock exists for the given key. * * @param string $key * @return bool */ public function exists($key) { return $this->connection()->exists($key) === 1; } /** * Attempt to get a lock for the given key. * * @param string $key * @param int $seconds * @return bool */ public function get($key, $seconds = 60) { $result = $this->connection()->setnx($key, 1); if ($result === 1) { $this->connection()->expire($key, $seconds); } return $result === 1; } /** * Release the lock for the given key. * * @param string $key * @return void */ public function release($key) { $this->connection()->del($key); } /** * Get the Redis connection instance. * * @return \Illuminate\Redis\Connections\Connection */ public function connection() { return $this->redis->connection('horizon'); } } PK ! [7K�J J Contracts/JobRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; use Illuminate\Support\Collection; use Laravel\Horizon\JobPayload; interface JobRepository { /** * Get the next job ID that should be assigned. * * @return string */ public function nextJobId(); /** * Get the total count of recent jobs. * * @return int */ public function totalRecent(); /** * Get the total count of failed jobs. * * @return int */ public function totalFailed(); /** * Get a chunk of recent jobs. * * @param string $afterIndex * @return \Illuminate\Support\Collection */ public function getRecent($afterIndex = null); /** * Get a chunk of failed jobs. * * @param string $afterIndex * @return \Illuminate\Support\Collection */ public function getFailed($afterIndex = null); /** * Get a chunk of pending jobs. * * @param string $afterIndex * @return \Illuminate\Support\Collection */ public function getPending($afterIndex = null); /** * Get a chunk of completed jobs. * * @param string $afterIndex * @return \Illuminate\Support\Collection */ public function getCompleted($afterIndex = null); /** * Get a chunk of silenced jobs. * * @param string $afterIndex * @return \Illuminate\Support\Collection */ public function getSilenced($afterIndex = null); /** * Get the count of recent jobs. * * @return int */ public function countRecent(); /** * Get the count of failed jobs. * * @return int */ public function countFailed(); /** * Get the count of pending jobs. * * @return int */ public function countPending(); /** * Get the count of completed jobs. * * @return int */ public function countCompleted(); /** * Get the count of silenced jobs. * * @return int */ public function countSilenced(); /** * Get the count of the recently failed jobs. * * @return int */ public function countRecentlyFailed(); /** * Retrieve the jobs with the given IDs. * * @param array $ids * @param mixed $indexFrom * @return \Illuminate\Support\Collection */ public function getJobs(array $ids, $indexFrom = 0); /** * Insert the job into storage. * * @param string $connection * @param string $queue * @param \Laravel\Horizon\JobPayload $payload * @return void */ public function pushed($connection, $queue, JobPayload $payload); /** * Mark the job as reserved. * * @param string $connection * @param string $queue * @param \Laravel\Horizon\JobPayload $payload * @return void */ public function reserved($connection, $queue, JobPayload $payload); /** * Mark the job as released / pending. * * @param string $connection * @param string $queue * @param \Laravel\Horizon\JobPayload $payload * @return void */ public function released($connection, $queue, JobPayload $payload); /** * Mark the job as completed and monitored. * * @param string $connection * @param string $queue * @param \Laravel\Horizon\JobPayload $payload * @return void */ public function remember($connection, $queue, JobPayload $payload); /** * Mark the given jobs as released / pending. * * @param string $connection * @param string $queue * @param \Illuminate\Support\Collection $payloads * @return void */ public function migrated($connection, $queue, Collection $payloads); /** * Handle the storage of a completed job. * * @param \Laravel\Horizon\JobPayload $payload * @param bool $failed * @param bool $silenced * @return void */ public function completed(JobPayload $payload, $failed = false, $silenced = false); /** * Delete the given monitored jobs by IDs. * * @param array $ids * @return void */ public function deleteMonitored(array $ids); /** * Trim the recent job list. * * @return void */ public function trimRecentJobs(); /** * Trim the failed job list. * * @return void */ public function trimFailedJobs(); /** * Trim the monitored job list. * * @return void */ public function trimMonitoredJobs(); /** * Find a failed job by ID. * * @param string $id * @return \stdClass|null */ public function findFailed($id); /** * Mark the job as failed. * * @param \Exception $exception * @param string $connection * @param string $queue * @param \Laravel\Horizon\JobPayload $payload * @return void */ public function failed($exception, $connection, $queue, JobPayload $payload); /** * Store the retry job ID on the original job record. * * @param string $id * @param string $retryId * @return void */ public function storeRetryReference($id, $retryId); /** * Delete a failed job by ID. * * @param string $id * @return int */ public function deleteFailed($id); } PK ! �N%r� � Contracts/WorkloadRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; interface WorkloadRepository { /** * Get the current workload of each queue. * * @return array */ public function get(); } PK ! �ӭ%� � Contracts/Restartable.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; interface Restartable { /** * Restart the process. * * @return void */ public function restart(); } PK ! !� ~� � Contracts/Terminable.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; interface Terminable { /** * Terminate the process. * * @param int $status * @return void */ public function terminate($status = 0); } PK ! �vKMD D Contracts/Silenced.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; interface Silenced { } PK ! <�y�� � Contracts/MetricsRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; interface MetricsRepository { /** * Get all of the class names that have metrics measurements. * * @return array */ public function measuredJobs(); /** * Get all of the queues that have metrics measurements. * * @return array */ public function measuredQueues(); /** * Get the jobs processed per minute since the last snapshot. * * @return int */ public function jobsProcessedPerMinute(); /** * Get the application's total throughput since the last snapshot. * * @return int */ public function throughput(); /** * Get the throughput for a given job. * * @param string $job * @return int */ public function throughputForJob($job); /** * Get the throughput for a given queue. * * @param string $queue * @return int */ public function throughputForQueue($queue); /** * Get the average runtime for a given job in milliseconds. * * @param string $job * @return float */ public function runtimeForJob($job); /** * Get the average runtime for a given queue in milliseconds. * * @param string $queue * @return float */ public function runtimeForQueue($queue); /** * Get the queue that has the longest runtime. * * @return int */ public function queueWithMaximumRuntime(); /** * Get the queue that has the most throughput. * * @return int */ public function queueWithMaximumThroughput(); /** * Increment the metrics information for a job. * * @param string $job * @param float|null $runtime * @return void */ public function incrementJob($job, $runtime); /** * Increment the metrics information for a queue. * * @param string $queue * @param float|null $runtime * @return void */ public function incrementQueue($queue, $runtime); /** * Get all of the snapshots for the given job. * * @param string $job * @return array */ public function snapshotsForJob($job); /** * Get all of the snapshots for the given queue. * * @param string $queue * @return array */ public function snapshotsForQueue($queue); /** * Store a snapshot of the metrics information. * * @return void */ public function snapshot(); /** * Attempt to acquire a lock to monitor the queue wait times. * * @return bool */ public function acquireWaitTimeMonitorLock(); /** * Clear the metrics for a key. * * @param string $key * @return void */ public function forget($key); /** * Delete all stored metrics information. * * @return void */ public function clear(); } PK ! �"2ۂ � ! Contracts/HorizonCommandQueue.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; interface HorizonCommandQueue { /** * Push a command onto a queue. * * @param string $name * @param string $command * @param array $options * @return void */ public function push($name, $command, array $options = []); /** * Get the pending commands for a given queue name. * * @param string $name * @return array */ public function pending($name); /** * Flush the command queue for a given queue name. * * @param string $name * @return void */ public function flush($name); } PK ! �>�"� � Contracts/ProcessRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; interface ProcessRepository { /** * Get all of the orphan process IDs and the times they were observed. * * @param string $master * @return array */ public function allOrphans($master); /** * Record the given process IDs as orphaned. * * @param string $master * @param array $processIds * @return array */ public function orphaned($master, array $processIds); /** * Get the process IDs orphaned for at least the given number of seconds. * * @param string $master * @param int $seconds * @return array */ public function orphanedFor($master, $seconds); /** * Remove the given process IDs from the orphan list. * * @param string $master * @param array $processIds * @return void */ public function forgetOrphans($master, array $processIds); } PK ! e�9XL L " Contracts/SupervisorRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; use Laravel\Horizon\Supervisor; interface SupervisorRepository { /** * Get the names of all the supervisors currently running. * * @return array */ public function names(); /** * Get information on all of the supervisors. * * @return array */ public function all(); /** * Get information on a supervisor by name. * * @param string $name * @return array */ public function find($name); /** * Get information on the given supervisors. * * @param array $names * @return array */ public function get(array $names); /** * Get the longest active timeout setting for a supervisor. * * @return int */ public function longestActiveTimeout(); /** * Update the information about the given supervisor process. * * @param \Laravel\Horizon\Supervisor $supervisor * @return void */ public function update(Supervisor $supervisor); /** * Remove the supervisor information from storage. * * @param array|string $names * @return void */ public function forget($names); /** * Remove expired supervisors from storage. * * @return void */ public function flushExpired(); } PK ! ���%� � Contracts/TagRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; interface TagRepository { /** * Get the currently monitored tags. * * @return array */ public function monitoring(); /** * Return the tags which are being monitored. * * @param array $tags * @return array */ public function monitored(array $tags); /** * Start monitoring the given tag. * * @param string $tag * @return void */ public function monitor($tag); /** * Stop monitoring the given tag. * * @param string $tag * @return void */ public function stopMonitoring($tag); /** * Store the tags for the given job. * * @param string $id * @param array $tags * @return void */ public function add($id, array $tags); /** * Store the tags for the given job temporarily. * * @param int $minutes * @param string $id * @param array $tags * @return void */ public function addTemporary($minutes, $id, array $tags); /** * Get the number of jobs matching a given tag. * * @param string $tag * @return int */ public function count($tag); /** * Get all of the job IDs for a given tag. * * @param string $tag * @return array */ public function jobs($tag); /** * Paginate the job IDs for a given tag. * * @param string $tag * @param int $startingAt * @param int $limit * @return array */ public function paginate($tag, $startingAt = 0, $limit = 25); /** * Delete the given tag from storage. * * @param string $tag * @return void */ public function forget($tag); } PK ! ���# # Contracts/Pausable.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; interface Pausable { /** * Pause the process. * * @return void */ public function pause(); /** * Instruct the process to continue working. * * @return void */ public function continue(); } PK ! '�i�� � ( Contracts/MasterSupervisorRepository.phpnu ȯ�� <?php namespace Laravel\Horizon\Contracts; use Laravel\Horizon\MasterSupervisor; interface MasterSupervisorRepository { /** * Get the names of all the master supervisors currently running. * * @return array */ public function names(); /** * Get information on all of the master supervisors. * * @return array */ public function all(); /** * Get information on a master supervisor by name. * * @param string $name * @return array */ public function find($name); /** * Get information on the given master supervisors. * * @param array $names * @return array */ public function get(array $names); /** * Update the information about the given master supervisor. * * @param \Laravel\Horizon\MasterSupervisor $master * @return void */ public function update(MasterSupervisor $master); /** * Remove the master supervisor information from storage. * * @param string $name * @return void */ public function forget($name); /** * Remove expired master supervisors from storage. * * @return void */ public function flushExpired(); } PK ! ���� � AutoScaler.phpnu ȯ�� <?php namespace Laravel\Horizon; use Illuminate\Contracts\Queue\Factory as QueueFactory; use Illuminate\Support\Collection; use Laravel\Horizon\Contracts\MetricsRepository; class AutoScaler { /** * The queue factory implementation. * * @var \Illuminate\Contracts\Queue\Factory */ public $queue; /** * The metrics repository implementation. * * @var \Laravel\Horizon\Contracts\MetricsRepository */ public $metrics; /** * Create a new auto-scaler instance. * * @param \Illuminate\Contracts\Queue\Factory $queue * @param \Laravel\Horizon\Contracts\MetricsRepository $metrics * @return void */ public function __construct(QueueFactory $queue, MetricsRepository $metrics) { $this->queue = $queue; $this->metrics = $metrics; } /** * Balance the workers on the given supervisor. * * @param \Laravel\Horizon\Supervisor $supervisor * @return void */ public function scale(Supervisor $supervisor) { $pools = $this->poolsByQueue($supervisor); $workers = $this->numberOfWorkersPerQueue( $supervisor, $this->timeToClearPerQueue($supervisor, $pools) ); $workers->each(function ($workers, $queue) use ($supervisor, $pools) { $this->scalePool($supervisor, $pools[$queue], $workers); }); } /** * Get the process pools keyed by their queue name. * * @param \Laravel\Horizon\Supervisor $supervisor * @return \Illuminate\Support\Collection */ protected function poolsByQueue(Supervisor $supervisor) { return $supervisor->processPools->mapWithKeys(function ($pool) { return [$pool->queue() => $pool]; }); } /** * Get the times in milliseconds needed to clear the queues. * * @param \Laravel\Horizon\Supervisor $supervisor * @param \Illuminate\Support\Collection $pools * @return \Illuminate\Support\Collection */ protected function timeToClearPerQueue(Supervisor $supervisor, Collection $pools) { return $pools->mapWithKeys(function ($pool, $queue) use ($supervisor) { $queues = collect(explode(',', $queue))->map(function ($_queue) use ($supervisor) { $size = $this->queue->connection($supervisor->options->connection)->readyNow($_queue); return [ 'size' => $size, 'time' => ($size * $this->metrics->runtimeForQueue($_queue)), ]; }); return [$queue => [ 'size' => $queues->sum('size'), 'time' => $queues->sum('time'), ]]; }); } /** * Get the number of workers needed per queue for proper balance. * * @param \Laravel\Horizon\Supervisor $supervisor * @param \Illuminate\Support\Collection $queues * @return \Illuminate\Support\Collection */ protected function numberOfWorkersPerQueue(Supervisor $supervisor, Collection $queues) { $timeToClearAll = $queues->sum('time'); $totalJobs = $queues->sum('size'); return $queues->mapWithKeys(function ($timeToClear, $queue) use ($supervisor, $timeToClearAll, $totalJobs) { if ($timeToClearAll > 0 && $supervisor->options->autoScaling()) { $numberOfProcesses = $supervisor->options->autoScaleByNumberOfJobs() ? ($timeToClear['size'] / $totalJobs) : ($timeToClear['time'] / $timeToClearAll); return [$queue => $numberOfProcesses *= $supervisor->options->maxProcesses]; } elseif ($timeToClearAll == 0 && $supervisor->options->autoScaling()) { return [ $queue => $timeToClear['size'] ? $supervisor->options->maxProcesses : $supervisor->options->minProcesses, ]; } return [$queue => $supervisor->options->maxProcesses / count($supervisor->processPools)]; })->sort(); } /** * Scale the given pool to the recommended number of workers. * * @param \Laravel\Horizon\Supervisor $supervisor * @param \Laravel\Horizon\ProcessPool $pool * @param float $workers * @return void */ protected function scalePool(Supervisor $supervisor, $pool, $workers) { $supervisor->pruneTerminatingProcesses(); $totalProcessCount = $pool->totalProcessCount(); $desiredProcessCount = ceil($workers); if ($desiredProcessCount > $totalProcessCount) { $maxUpShift = min( max(0, $supervisor->options->maxProcesses - $supervisor->totalProcessCount()), $supervisor->options->balanceMaxShift ); $pool->scale( min( $totalProcessCount + $maxUpShift, max($supervisor->options->minProcesses, $supervisor->options->maxProcesses - (($supervisor->processPools->count() - 1) * $supervisor->options->minProcesses)), $desiredProcessCount ) ); } elseif ($desiredProcessCount < $totalProcessCount) { $maxDownShift = min( $supervisor->totalProcessCount() - $supervisor->options->minProcesses, $supervisor->options->balanceMaxShift ); $pool->scale( max( $totalProcessCount - $maxDownShift, $supervisor->options->minProcesses, $desiredProcessCount ) ); } } } PK ! �;�� � ListensForSignals.phpnu ȯ�� <?php namespace Laravel\Horizon; use Illuminate\Support\Arr; trait ListensForSignals { /** * The pending signals that need to be processed. * * @var array */ protected $pendingSignals = []; /** * Listen for incoming process signals. * * @return void */ protected function listenForSignals() { pcntl_async_signals(true); pcntl_signal(SIGTERM, function () { $this->pendingSignals['terminate'] = 'terminate'; }); pcntl_signal(SIGUSR1, function () { $this->pendingSignals['restart'] = 'restart'; }); pcntl_signal(SIGUSR2, function () { $this->pendingSignals['pause'] = 'pause'; }); pcntl_signal(SIGCONT, function () { $this->pendingSignals['continue'] = 'continue'; }); } /** * Process the pending signals. * * @return void */ protected function processPendingSignals() { while ($this->pendingSignals) { $signal = Arr::first($this->pendingSignals); $this->{$signal}(); unset($this->pendingSignals[$signal]); } } } PK ! v�煷 � WorkerCommandString.phpnu ȯ�� <?php namespace Laravel\Horizon; class WorkerCommandString { /** * The base worker command. * * @var string */ public static $command = 'exec @php artisan horizon:work'; /** * Get the command-line representation of the options for a worker. * * @param \Laravel\Horizon\SupervisorOptions $options * @return string */ public static function fromOptions(SupervisorOptions $options) { $command = str_replace('@php', PhpBinary::path(), static::$command); return sprintf( "%s {$options->connection} %s", $command, static::toOptionsString($options) ); } /** * Get the additional option string for the command. * * @param \Laravel\Horizon\SupervisorOptions $options * @return string */ public static function toOptionsString(SupervisorOptions $options) { return QueueCommandString::toWorkerOptionsString($options); } /** * Reset the base command back to its default value. * * @return void */ public static function reset() { static::$command = 'exec @php artisan horizon:work'; } } PK ! ,�$ $ ProvisioningPlan.phpnu ȯ�� <?php namespace Laravel\Horizon; use Exception; use Illuminate\Support\Arr; use Illuminate\Support\Str; use Laravel\Horizon\Contracts\HorizonCommandQueue; use Laravel\Horizon\Events\MasterSupervisorDeployed; use Laravel\Horizon\MasterSupervisorCommands\AddSupervisor; class ProvisioningPlan { /** * The master supervisor's name. * * @var string */ public $master; /** * The raw provisioning plan. * * @var array */ public $plan; /** * The parsed provisioning plan. * * @var array */ public $parsed; /** * Create a new provisioning plan instance. * * @param string $master * @param array $plan * @param array $defaults * @return void */ public function __construct($master, array $plan, array $defaults = []) { $this->plan = $this->applyDefaultOptions($plan, $defaults); $this->master = $master; $this->parsed = $this->toSupervisorOptions(); } /** * Get the current provisioning plan. * * @param string $master * @return static */ public static function get($master) { return new static($master, config('horizon.environments'), config('horizon.defaults', [])); } /** * Apply the default supervisor options to each environment. * * @param array $plan * @param array $defaults * @return array */ protected function applyDefaultOptions(array $plan, array $defaults = []) { return collect($plan)->map(function ($plan) use ($defaults) { return array_replace_recursive($defaults, $plan); })->all(); } /** * Get all of the defined environments for the provisioning plan. * * @return array */ public function environments() { return array_keys($this->parsed); } /** * Determine if the provisioning plan has a given environment. * * @param string $environment * @return bool */ public function hasEnvironment($environment) { return array_key_exists($environment, $this->parsed); } /** * Deploy a provisioning plan to the current machine. * * @param string $environment * @return void */ public function deploy($environment) { $supervisors = collect($this->parsed)->first(function ($_, $name) use ($environment) { return Str::is($name, $environment); }); if (empty($supervisors)) { return; } foreach ($supervisors as $supervisor => $options) { $this->add($options); } event(new MasterSupervisorDeployed($this->master)); } /** * Add a supervisor with the given options. * * @param \Laravel\Horizon\SupervisorOptions $options * @return void */ protected function add(SupervisorOptions $options) { app(HorizonCommandQueue::class)->push( MasterSupervisor::commandQueueFor($this->master), AddSupervisor::class, $options->toArray() ); } /** * Get the SupervisorOptions for a given environment and supervisor. * * @param string $environment * @param string $supervisor * @return mixed */ public function optionsFor($environment, $supervisor) { if (isset($this->parsed[$environment]) && isset($this->parsed[$environment][$supervisor])) { return $this->parsed[$environment][$supervisor]; } } /** * Convert the provisioning plan into an array of SupervisorOptions. * * @return array */ public function toSupervisorOptions() { return collect($this->plan)->mapWithKeys(function ($plan, $environment) { return [$environment => collect($plan)->mapWithKeys(function ($options, $supervisor) { return [$supervisor => $this->convert($supervisor, $options)]; })]; })->all(); } /** * Convert the given array of options into a SupervisorOptions instance. * * @param string $supervisor * @param array $options * @return \Laravel\Horizon\SupervisorOptions */ protected function convert($supervisor, $options) { $options = collect($options)->mapWithKeys(function ($value, $key) { $key = $key === 'tries' ? 'max_tries' : $key; $key = $key === 'processes' ? 'max_processes' : $key; $value = $key === 'queue' && is_array($value) ? implode(',', $value) : $value; $value = $key === 'backoff' && is_array($value) ? implode(',', $value) : $value; return [Str::camel($key) => $value]; })->all(); if (isset($options['minProcesses']) && $options['minProcesses'] < 1) { throw new Exception("The value of [{$supervisor}.minProcesses] must be greater than 0."); } $options['parentId'] = getmypid(); return SupervisorOptions::fromArray( Arr::add($options, 'name', $this->master.":{$supervisor}") ); } } PK ! c � � Events/SupervisorOutOfMemory.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; use Laravel\Horizon\Supervisor; class SupervisorOutOfMemory { /** * The supervisor instance. * * @var \Laravel\Horizon\Supervisor */ public $supervisor; /** * Create a new event instance. * * @param \Laravel\Horizon\Supervisor $supervisor * @return void */ public function __construct(Supervisor $supervisor) { $this->supervisor = $supervisor; } } PK ! ��oZ Z Events/JobReserved.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; class JobReserved extends RedisEvent { // } PK ! �_�/X X Events/JobPushed.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; class JobPushed extends RedisEvent { // } PK ! �dq�| | # Events/MasterSupervisorReviving.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; class MasterSupervisorReviving { /** * The master supervisor that was dead. * * @var string */ public $master; /** * Create a new event instance. * * @param string $master * @return void */ public function __construct($master) { $this->master = $master; } } PK ! ��X�� � ! Events/MasterSupervisorLooped.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; use Laravel\Horizon\MasterSupervisor; class MasterSupervisorLooped { /** * The master supervisor instance. * * @var \Laravel\Horizon\MasterSupervisor */ public $master; /** * Create a new event instance. * * @param \Laravel\Horizon\MasterSupervisor $master * @return void */ public function __construct(MasterSupervisor $master) { $this->master = $master; } } PK ! Ym�2L L Events/LongWaitDetected.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; use Laravel\Horizon\Notifications\LongWaitDetected as LongWaitDetectedNotification; class LongWaitDetected { /** * The queue connection name. * * @var string */ public $connection; /** * The queue name. * * @var string */ public $queue; /** * The wait time in seconds. * * @var int */ public $seconds; /** * Create a new event instance. * * @param string $connection * @param string $queue * @param int $seconds * @return void */ public function __construct($connection, $queue, $seconds) { $this->queue = $queue; $this->seconds = $seconds; $this->connection = $connection; } /** * Get a notification representation of the event. * * @return \Laravel\Horizon\Notifications\LongWaitDetected */ public function toNotification() { return new LongWaitDetectedNotification( $this->connection, $this->queue, $this->seconds ); } } PK ! R�q�� � Events/JobDeleted.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; class JobDeleted extends RedisEvent { /** * The queue job instance. * * @var \Illuminate\Queue\Jobs\Job */ public $job; /** * Create a new event instance. * * @param \Illuminate\Queue\Jobs\Job $job * @param string $payload * @return void */ public function __construct($job, $payload) { $this->job = $job; parent::__construct($payload); } } PK ! 6�\4� � Events/UnableToLaunchProcess.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; use Laravel\Horizon\WorkerProcess; class UnableToLaunchProcess { /** * The worker process instance. * * @var \Laravel\Horizon\WorkerProcess */ public $process; /** * Create a new event instance. * * @param \Laravel\Horizon\WorkerProcess $process * @return void */ public function __construct(WorkerProcess $process) { $this->process = $process; } } PK ! A)�Z Z Events/JobReleased.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; class JobReleased extends RedisEvent { // } PK ! P ⸀ � # Events/MasterSupervisorDeployed.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; class MasterSupervisorDeployed { /** * The master supervisor that was deployed. * * @var string */ public $master; /** * Create a new event instance. * * @param string $master * @return void */ public function __construct($master) { $this->master = $master; } } PK ! U�P�� � Events/JobsMigrated.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; use Laravel\Horizon\JobPayload; class JobsMigrated { /** * The connection name. * * @var string */ public $connectionName; /** * The queue name. * * @var string */ public $queue; /** * The job payloads that were migrated. * * @var \Illuminate\Support\Collection */ public $payloads; /** * Create a new event instance. * * @param array $payloads * @return void */ public function __construct($payloads) { $this->payloads = collect($payloads)->map(function ($job) { return new JobPayload($job); }); } /** * Set the connection name. * * @param string $connectionName * @return $this */ public function connection($connectionName) { $this->connectionName = $connectionName; return $this; } /** * Set the queue name. * * @param string $queue * @return $this */ public function queue($queue) { $this->queue = $queue; return $this; } } PK ! V7m�� � " Events/WorkerProcessRestarting.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; use Laravel\Horizon\WorkerProcess; class WorkerProcessRestarting { /** * The worker process instance. * * @var \Laravel\Horizon\WorkerProcess */ public $process; /** * Create a new event instance. * * @param \Laravel\Horizon\WorkerProcess $process * @return void */ public function __construct(WorkerProcess $process) { $this->process = $process; } } PK ! ���� � Events/JobFailed.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; class JobFailed extends RedisEvent { /** * The exception that caused the failure. * * @var \Exception */ public $exception; /** * The queue job instance. * * @var \Illuminate\Queue\Jobs\Job */ public $job; /** * Create a new event instance. * * @param \Exception $exception * @param \Illuminate\Queue\Jobs\Job $job * @param string $payload * @return void */ public function __construct($exception, $job, $payload) { $this->job = $job; $this->exception = $exception; parent::__construct($payload); } } PK ! �iZW� � & Events/SupervisorProcessRestarting.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; use Laravel\Horizon\SupervisorProcess; class SupervisorProcessRestarting { /** * The supervisor process instance. * * @var \Laravel\Horizon\SupervisorProcess */ public $process; /** * Create a new event instance. * * @param \Laravel\Horizon\SupervisorProcess $process * @return void */ public function __construct(SupervisorProcess $process) { $this->process = $process; } } PK ! �K�d� � Events/SupervisorLooped.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; use Laravel\Horizon\Supervisor; class SupervisorLooped { /** * The supervisor instance. * * @var \Laravel\Horizon\Supervisor */ public $supervisor; /** * Create a new event instance. * * @param \Laravel\Horizon\Supervisor $supervisor * @return void */ public function __construct(Supervisor $supervisor) { $this->supervisor = $supervisor; } } PK ! ^� Events/RedisEvent.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; use Laravel\Horizon\JobPayload; class RedisEvent { /** * The connection name. * * @var string */ public $connectionName; /** * The queue name. * * @var string */ public $queue; /** * The job payload. * * @var JobPayload */ public $payload; /** * Create a new event instance. * * @param string $payload * @return void */ public function __construct($payload) { $this->payload = new JobPayload($payload); } /** * Set the connection name. * * @param string $connectionName * @return $this */ public function connection($connectionName) { $this->connectionName = $connectionName; return $this; } /** * Set the queue name. * * @param string $queue * @return $this */ public function queue($queue) { $this->queue = $queue; return $this; } } PK ! -.A� � & Events/MasterSupervisorOutOfMemory.phpnu ȯ�� <?php namespace Laravel\Horizon\Events; use Laravel\Horizon\MasterSupervisor; class MasterSupervisorOutOfMemory { /** * The master supervisor instance. * * @var \Laravel\Horizon\MasterSupervisor */ public $master; /** * Create a new event instance. * * @param \Laravel\Horizon\MasterSupervisor $master * @return void */ public function __construct(MasterSupervisor $master) { $this->master = $master; } } PK ! RM��i i Horizon.phpnu ȯ�� <?php namespace Laravel\Horizon; use Closure; use Exception; use Illuminate\Support\HtmlString; use Illuminate\Support\Js; use RuntimeException; class Horizon { /** * The callback that should be used to authenticate Horizon users. * * @var \Closure */ public static $authUsing; /** * The Slack notifications webhook URL. * * @var string */ public static $slackWebhookUrl; /** * The Slack notifications channel. * * @var string */ public static $slackChannel; /** * The SMS notifications phone number. * * @var string */ public static $smsNumber; /** * The email address for notifications. * * @var string */ public static $email; /** * Indicates if Horizon should use the dark theme. * * @deprecated * * @var bool */ public static $useDarkTheme = false; /** * The database configuration methods. * * @var array */ public static $databases = [ 'Jobs', 'Supervisors', 'CommandQueue', 'Tags', 'Metrics', 'Locks', 'Processes', ]; /** * Determine if the given request can access the Horizon dashboard. * * @param \Illuminate\Http\Request $request * @return bool */ public static function check($request) { return (static::$authUsing ?: function () { return app()->environment('local'); })($request); } /** * Set the callback that should be used to authenticate Horizon users. * * @param \Closure $callback * @return static */ public static function auth(Closure $callback) { static::$authUsing = $callback; return new static; } /** * Configure the Redis databases that will store Horizon data. * * @param string $connection * @return void * * @throws \Exception */ public static function use($connection) { if (! is_null($config = config("database.redis.clusters.{$connection}.0"))) { config(["database.redis.{$connection}" => $config]); } elseif (is_null($config) && is_null($config = config("database.redis.{$connection}"))) { throw new Exception("Redis connection [{$connection}] has not been configured."); } $config['options']['prefix'] = config('horizon.prefix') ?: 'horizon:'; config(['database.redis.horizon' => $config]); } /** * Get the CSS for the Horizon dashboard. * * @return Illuminate\Contracts\Support\Htmlable */ public static function css() { if (($light = @file_get_contents(__DIR__.'/../dist/styles.css')) === false) { throw new RuntimeException('Unable to load the Horizon dashboard light CSS.'); } if (($dark = @file_get_contents(__DIR__.'/../dist/styles-dark.css')) === false) { throw new RuntimeException('Unable to load the Horizon dashboard dark CSS.'); } if (($app = @file_get_contents(__DIR__.'/../dist/app.css')) === false) { throw new RuntimeException('Unable to load the Horizon dashboard CSS.'); } return new HtmlString(<<<HTML <style data-scheme="light">{$light}</style> <style data-scheme="dark">{$dark}</style> <style>{$app}</style> HTML); } /** * Get the JS for the Horizon dashboard. * * @return \Illuminate\Contracts\Support\Htmlable */ public static function js() { if (($js = @file_get_contents(__DIR__.'/../dist/app.js')) === false) { throw new RuntimeException('Unable to load the Horizon dashboard JavaScript.'); } $horizon = Js::from(static::scriptVariables()); return new HtmlString(<<<HTML <script type="module"> window.Horizon = {$horizon}; {$js} </script> HTML); } /** * Specifies that Horizon should use the dark theme. * * @deprecated * * @return static */ public static function night() { static::$useDarkTheme = true; return new static; } /** * Get the default JavaScript variables for Horizon. * * @return array */ public static function scriptVariables() { return [ 'path' => config('horizon.path'), ]; } /** * Specify the email address to which email notifications should be routed. * * @param string $email * @return static */ public static function routeMailNotificationsTo($email) { static::$email = $email; return new static; } /** * Specify the webhook URL and channel to which Slack notifications should be routed. * * @param string $url * @param string $channel * @return static */ public static function routeSlackNotificationsTo($url, $channel = null) { static::$slackWebhookUrl = $url; static::$slackChannel = $channel; return new static; } /** * Specify the phone number to which SMS notifications should be routed. * * @param string $number * @return static */ public static function routeSmsNotificationsTo($number) { static::$smsNumber = $number; return new static; } } PK ! ���v� � Exception/LogicException.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Exception; class LogicException extends \LogicException implements CommonMarkException { } PK ! �]�w� � ) Exception/UnexpectedEncodingException.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Exception; final class UnexpectedEncodingException extends \RuntimeException implements CommonMarkException { } PK ! �&D� � ! Exception/CommonMarkException.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Exception; /** * Marker interface for all exceptions thrown by this library. */ interface CommonMarkException extends \Throwable { } PK ! � � � ) Exception/AlreadyInitializedException.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Exception; class AlreadyInitializedException extends LogicException implements CommonMarkException { } PK ! V�� � Exception/IOException.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Exception; class IOException extends \RuntimeException implements CommonMarkException { } PK ! ��� � ( Exception/MissingDependencyException.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Exception; class MissingDependencyException extends \RuntimeException implements CommonMarkException { } PK ! d{�}\ \ & Exception/InvalidArgumentException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use InvalidArgumentException as PhpInvalidArgumentException; /** * Thrown to indicate that the argument received is not valid */ class InvalidArgumentException extends PhpInvalidArgumentException implements UuidExceptionInterface { } PK ! �� �� � # GithubFlavoredMarkdownConverter.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark; use League\CommonMark\Environment\Environment; use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension; use League\CommonMark\Extension\GithubFlavoredMarkdownExtension; /** * Converts GitHub Flavored Markdown to HTML. */ final class GithubFlavoredMarkdownConverter extends MarkdownConverter { /** * Create a new Markdown converter pre-configured for GFM * * @param array<string, mixed> $config */ public function __construct(array $config = []) { $environment = new Environment($config); $environment->addExtension(new CommonMarkCoreExtension()); $environment->addExtension(new GithubFlavoredMarkdownExtension()); parent::__construct($environment); } public function getEnvironment(): Environment { \assert($this->environment instanceof Environment); return $this->environment; } } PK ! �:�U> > MarkdownConverter.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark; use League\CommonMark\Environment\EnvironmentInterface; use League\CommonMark\Exception\CommonMarkException; use League\CommonMark\Output\RenderedContentInterface; use League\CommonMark\Parser\MarkdownParser; use League\CommonMark\Parser\MarkdownParserInterface; use League\CommonMark\Renderer\HtmlRenderer; use League\CommonMark\Renderer\MarkdownRendererInterface; class MarkdownConverter implements ConverterInterface, MarkdownConverterInterface { /** @psalm-readonly */ protected EnvironmentInterface $environment; /** @psalm-readonly */ protected MarkdownParserInterface $markdownParser; /** @psalm-readonly */ protected MarkdownRendererInterface $htmlRenderer; public function __construct(EnvironmentInterface $environment) { $this->environment = $environment; $this->markdownParser = new MarkdownParser($environment); $this->htmlRenderer = new HtmlRenderer($environment); } public function getEnvironment(): EnvironmentInterface { return $this->environment; } /** * Converts Markdown to HTML. * * @param string $input The Markdown to convert * * @return RenderedContentInterface Rendered HTML * * @throws CommonMarkException */ public function convert(string $input): RenderedContentInterface { $documentAST = $this->markdownParser->parse($input); return $this->htmlRenderer->renderDocument($documentAST); } /** * Converts Markdown to HTML. * * @deprecated since 2.2; use {@link convert()} instead * * @param string $markdown The Markdown to convert * * @return RenderedContentInterface Rendered HTML * * @throws CommonMarkException */ public function convertToHtml(string $markdown): RenderedContentInterface { \trigger_deprecation('league/commonmark', '2.2.0', 'Calling "convertToHtml()" on a %s class is deprecated, use "convert()" instead.', self::class); return $this->convert($markdown); } /** * Converts CommonMark to HTML. * * @see MarkdownConverter::convert() * * @throws CommonMarkException */ public function __invoke(string $markdown): RenderedContentInterface { return $this->convert($markdown); } } PK ! �i ConverterInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark; use League\CommonMark\Exception\CommonMarkException; use League\CommonMark\Output\RenderedContentInterface; use League\Config\Exception\ConfigurationExceptionInterface; /** * Interface for a service which converts content from one format (like Markdown) to another (like HTML). */ interface ConverterInterface { /** * @throws CommonMarkException * @throws ConfigurationExceptionInterface */ public function convert(string $input): RenderedContentInterface; } PK ! a�*D D Xml/MarkdownToXmlConverter.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Xml; use League\CommonMark\ConverterInterface; use League\CommonMark\Environment\EnvironmentInterface; use League\CommonMark\Exception\CommonMarkException; use League\CommonMark\Output\RenderedContentInterface; use League\CommonMark\Parser\MarkdownParser; use League\CommonMark\Parser\MarkdownParserInterface; use League\CommonMark\Renderer\DocumentRendererInterface; final class MarkdownToXmlConverter implements ConverterInterface { /** @psalm-readonly */ private MarkdownParserInterface $parser; /** @psalm-readonly */ private DocumentRendererInterface $renderer; public function __construct(EnvironmentInterface $environment) { $this->parser = new MarkdownParser($environment); $this->renderer = new XmlRenderer($environment); } /** * Converts Markdown to XML * * @throws CommonMarkException */ public function convert(string $input): RenderedContentInterface { return $this->renderer->renderDocument($this->parser->parse($input)); } /** * Converts CommonMark to HTML. * * @see MarkdownToXmlConverter::convert() * * @throws CommonMarkException */ public function __invoke(string $input): RenderedContentInterface { return $this->convert($input); } } PK ! � &*b b Xml/XmlNodeRendererInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Xml; use League\CommonMark\Node\Node; interface XmlNodeRendererInterface { public function getXmlTagName(Node $node): string; /** * @return array<string, string|int|float|bool> * * @psalm-return array<string, scalar> */ public function getXmlAttributes(Node $node): array; } PK ! i �>� � Xml/FallbackNodeXmlRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Xml; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Node\Inline\AbstractInline; use League\CommonMark\Node\Node; /** * @internal */ final class FallbackNodeXmlRenderer implements XmlNodeRendererInterface { /** * @var array<string, string> * * @psalm-allow-private-mutation */ private array $classCache = []; /** * @psalm-allow-private-mutation */ public function getXmlTagName(Node $node): string { $className = \get_class($node); if (isset($this->classCache[$className])) { return $this->classCache[$className]; } $type = $node instanceof AbstractBlock ? 'block' : 'inline'; $shortName = \strtolower((new \ReflectionClass($node))->getShortName()); return $this->classCache[$className] = \sprintf('custom_%s_%s', $type, $shortName); } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { $attrs = []; foreach ($node->data->export() as $k => $v) { if (self::isValueUsable($v)) { $attrs[$k] = $v; } } $reflClass = new \ReflectionClass($node); foreach ($reflClass->getProperties() as $property) { if (\in_array($property->getDeclaringClass()->getName(), [Node::class, AbstractBlock::class, AbstractInline::class], true)) { continue; } $property->setAccessible(true); $value = $property->getValue($node); if (self::isValueUsable($value)) { $attrs[$property->getName()] = $value; } } return $attrs; } /** * @param mixed $var * * @psalm-pure */ private static function isValueUsable($var): bool { return \is_string($var) || \is_int($var) || \is_float($var) || \is_bool($var); } } PK ! }"��F F Xml/XmlRenderer.phpnu ȯ�� <?php declare(strict_types=1); namespace League\CommonMark\Xml; use League\CommonMark\Environment\EnvironmentInterface; use League\CommonMark\Event\DocumentPreRenderEvent; use League\CommonMark\Exception\InvalidArgumentException; use League\CommonMark\Node\Block\Document; use League\CommonMark\Node\Node; use League\CommonMark\Node\StringContainerInterface; use League\CommonMark\Output\RenderedContent; use League\CommonMark\Output\RenderedContentInterface; use League\CommonMark\Renderer\DocumentRendererInterface; use League\CommonMark\Util\Xml; final class XmlRenderer implements DocumentRendererInterface { private const INDENTATION = ' '; private EnvironmentInterface $environment; private XmlNodeRendererInterface $fallbackRenderer; /** @var array<class-string, XmlNodeRendererInterface> */ private array $rendererCache = []; public function __construct(EnvironmentInterface $environment) { $this->environment = $environment; $this->fallbackRenderer = new FallbackNodeXmlRenderer(); } public function renderDocument(Document $document): RenderedContentInterface { $this->environment->dispatch(new DocumentPreRenderEvent($document, 'xml')); $xml = '<?xml version="1.0" encoding="UTF-8"?>'; $indent = 0; $walker = $document->walker(); while ($event = $walker->next()) { $node = $event->getNode(); $closeImmediately = ! $node->hasChildren(); $selfClosing = $closeImmediately && ! $node instanceof StringContainerInterface; $renderer = $this->findXmlRenderer($node); $tagName = $renderer->getXmlTagName($node); if ($event->isEntering()) { $attrs = $renderer->getXmlAttributes($node); $xml .= "\n" . \str_repeat(self::INDENTATION, $indent); $xml .= self::tag($tagName, $attrs, $selfClosing); if ($node instanceof StringContainerInterface) { $xml .= Xml::escape($node->getLiteral()); } if ($closeImmediately && ! $selfClosing) { $xml .= self::tag('/' . $tagName); } if (! $closeImmediately) { $indent++; } } elseif (! $closeImmediately) { $indent--; $xml .= "\n" . \str_repeat(self::INDENTATION, $indent); $xml .= self::tag('/' . $tagName); } } return new RenderedContent($document, $xml . "\n"); } /** * @param array<string, string|int|float|bool> $attrs */ private static function tag(string $name, array $attrs = [], bool $selfClosing = \false): string { $result = '<' . $name; foreach ($attrs as $key => $value) { $result .= \sprintf(' %s="%s"', $key, self::convertAndEscape($value)); } if ($selfClosing) { $result .= ' /'; } $result .= '>'; return $result; } /** * @param string|int|float|bool $value */ private static function convertAndEscape($value): string { if (\is_string($value)) { return Xml::escape($value); } if (\is_int($value) || \is_float($value)) { return (string) $value; } if (\is_bool($value)) { return $value ? 'true' : 'false'; } // @phpstan-ignore-next-line throw new InvalidArgumentException('$value must be a string, int, float, or bool'); } private function findXmlRenderer(Node $node): XmlNodeRendererInterface { $class = \get_class($node); if (\array_key_exists($class, $this->rendererCache)) { return $this->rendererCache[$class]; } foreach ($this->environment->getRenderersForClass($class) as $renderer) { if ($renderer instanceof XmlNodeRendererInterface) { return $this->rendererCache[$class] = $renderer; } } return $this->rendererCache[$class] = $this->fallbackRenderer; } } PK ! �!x,� � Delimiter/DelimiterInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Delimiter; use League\CommonMark\Node\Inline\AbstractStringContainer; interface DelimiterInterface { public function canClose(): bool; public function canOpen(): bool; public function isActive(): bool; public function setActive(bool $active): void; public function getChar(): string; public function getIndex(): ?int; public function getNext(): ?DelimiterInterface; public function setNext(?DelimiterInterface $next): void; public function getLength(): int; public function setLength(int $length): void; public function getOriginalLength(): int; public function getInlineNode(): AbstractStringContainer; public function getPrevious(): ?DelimiterInterface; public function setPrevious(?DelimiterInterface $previous): void; } PK ! d�(�p p Delimiter/DelimiterParser.phpnu ȯ�� <?php declare(strict_types=1); namespace League\CommonMark\Delimiter; use League\CommonMark\Delimiter\Processor\DelimiterProcessorCollection; use League\CommonMark\Delimiter\Processor\DelimiterProcessorInterface; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; use League\CommonMark\Util\RegexHelper; /** * Delimiter parsing is implemented as an Inline Parser with the lowest-possible priority * * @internal */ final class DelimiterParser implements InlineParserInterface { private DelimiterProcessorCollection $collection; public function __construct(DelimiterProcessorCollection $collection) { $this->collection = $collection; } public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::oneOf(...$this->collection->getDelimiterCharacters()); } public function parse(InlineParserContext $inlineContext): bool { $character = $inlineContext->getFullMatch(); $numDelims = 0; $cursor = $inlineContext->getCursor(); $processor = $this->collection->getDelimiterProcessor($character); \assert($processor !== null); // Delimiter processor should never be null here $charBefore = $cursor->peek(-1); if ($charBefore === null) { $charBefore = "\n"; } while ($cursor->peek($numDelims) === $character) { ++$numDelims; } if ($numDelims < $processor->getMinLength()) { return false; } $cursor->advanceBy($numDelims); $charAfter = $cursor->getCurrentCharacter(); if ($charAfter === null) { $charAfter = "\n"; } [$canOpen, $canClose] = self::determineCanOpenOrClose($charBefore, $charAfter, $character, $processor); $node = new Text(\str_repeat($character, $numDelims), [ 'delim' => true, ]); $inlineContext->getContainer()->appendChild($node); // Add entry to stack to this opener if ($canOpen || $canClose) { $delimiter = new Delimiter($character, $numDelims, $node, $canOpen, $canClose); $inlineContext->getDelimiterStack()->push($delimiter); } return true; } /** * @return bool[] */ private static function determineCanOpenOrClose(string $charBefore, string $charAfter, string $character, DelimiterProcessorInterface $delimiterProcessor): array { $afterIsWhitespace = \preg_match(RegexHelper::REGEX_UNICODE_WHITESPACE_CHAR, $charAfter); $afterIsPunctuation = \preg_match(RegexHelper::REGEX_PUNCTUATION, $charAfter); $beforeIsWhitespace = \preg_match(RegexHelper::REGEX_UNICODE_WHITESPACE_CHAR, $charBefore); $beforeIsPunctuation = \preg_match(RegexHelper::REGEX_PUNCTUATION, $charBefore); $leftFlanking = ! $afterIsWhitespace && (! $afterIsPunctuation || $beforeIsWhitespace || $beforeIsPunctuation); $rightFlanking = ! $beforeIsWhitespace && (! $beforeIsPunctuation || $afterIsWhitespace || $afterIsPunctuation); if ($character === '_') { $canOpen = $leftFlanking && (! $rightFlanking || $beforeIsPunctuation); $canClose = $rightFlanking && (! $leftFlanking || $afterIsPunctuation); } else { $canOpen = $leftFlanking && $character === $delimiterProcessor->getOpeningCharacter(); $canClose = $rightFlanking && $character === $delimiterProcessor->getClosingCharacter(); } return [$canOpen, $canClose]; } } PK ! ���� � Delimiter/DelimiterStack.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java) * - (c) Atlassian Pty Ltd * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Delimiter; use League\CommonMark\Delimiter\Processor\DelimiterProcessorCollection; use League\CommonMark\Node\Inline\AdjacentTextMerger; final class DelimiterStack { /** @psalm-readonly-allow-private-mutation */ private ?DelimiterInterface $top = null; public function push(DelimiterInterface $newDelimiter): void { $newDelimiter->setPrevious($this->top); if ($this->top !== null) { $this->top->setNext($newDelimiter); } $this->top = $newDelimiter; } private function findEarliest(?DelimiterInterface $stackBottom = null): ?DelimiterInterface { $delimiter = $this->top; while ($delimiter !== null && $delimiter->getPrevious() !== $stackBottom) { $delimiter = $delimiter->getPrevious(); } return $delimiter; } public function removeDelimiter(DelimiterInterface $delimiter): void { if ($delimiter->getPrevious() !== null) { /** @psalm-suppress PossiblyNullReference */ $delimiter->getPrevious()->setNext($delimiter->getNext()); } if ($delimiter->getNext() === null) { // top of stack $this->top = $delimiter->getPrevious(); } else { /** @psalm-suppress PossiblyNullReference */ $delimiter->getNext()->setPrevious($delimiter->getPrevious()); } } private function removeDelimiterAndNode(DelimiterInterface $delimiter): void { $delimiter->getInlineNode()->detach(); $this->removeDelimiter($delimiter); } private function removeDelimitersBetween(DelimiterInterface $opener, DelimiterInterface $closer): void { $delimiter = $closer->getPrevious(); while ($delimiter !== null && $delimiter !== $opener) { $previous = $delimiter->getPrevious(); $this->removeDelimiter($delimiter); $delimiter = $previous; } } public function removeAll(?DelimiterInterface $stackBottom = null): void { while ($this->top && $this->top !== $stackBottom) { $this->removeDelimiter($this->top); } } public function removeEarlierMatches(string $character): void { $opener = $this->top; while ($opener !== null) { if ($opener->getChar() === $character) { $opener->setActive(false); } $opener = $opener->getPrevious(); } } /** * @param string|string[] $characters */ public function searchByCharacter($characters): ?DelimiterInterface { if (! \is_array($characters)) { $characters = [$characters]; } $opener = $this->top; while ($opener !== null) { if (\in_array($opener->getChar(), $characters, true)) { break; } $opener = $opener->getPrevious(); } return $opener; } public function processDelimiters(?DelimiterInterface $stackBottom, DelimiterProcessorCollection $processors): void { $openersBottom = []; // Find first closer above stackBottom $closer = $this->findEarliest($stackBottom); // Move forward, looking for closers, and handling each while ($closer !== null) { $delimiterChar = $closer->getChar(); $delimiterProcessor = $processors->getDelimiterProcessor($delimiterChar); if (! $closer->canClose() || $delimiterProcessor === null) { $closer = $closer->getNext(); continue; } $openingDelimiterChar = $delimiterProcessor->getOpeningCharacter(); $useDelims = 0; $openerFound = false; $potentialOpenerFound = false; $opener = $closer->getPrevious(); while ($opener !== null && $opener !== $stackBottom && $opener !== ($openersBottom[$delimiterChar] ?? null)) { if ($opener->canOpen() && $opener->getChar() === $openingDelimiterChar) { $potentialOpenerFound = true; $useDelims = $delimiterProcessor->getDelimiterUse($opener, $closer); if ($useDelims > 0) { $openerFound = true; break; } } $opener = $opener->getPrevious(); } if (! $openerFound) { if (! $potentialOpenerFound) { // Only do this when we didn't even have a potential // opener (one that matches the character and can open). // If an opener was rejected because of the number of // delimiters (e.g. because of the "multiple of 3" // Set lower bound for future searches for openersrule), // we want to consider it next time because the number // of delimiters can change as we continue processing. $openersBottom[$delimiterChar] = $closer->getPrevious(); if (! $closer->canOpen()) { // We can remove a closer that can't be an opener, // once we've seen there's no matching opener. $this->removeDelimiter($closer); } } $closer = $closer->getNext(); continue; } \assert($opener !== null); $openerNode = $opener->getInlineNode(); $closerNode = $closer->getInlineNode(); // Remove number of used delimiters from stack and inline nodes. $opener->setLength($opener->getLength() - $useDelims); $closer->setLength($closer->getLength() - $useDelims); $openerNode->setLiteral(\substr($openerNode->getLiteral(), 0, -$useDelims)); $closerNode->setLiteral(\substr($closerNode->getLiteral(), 0, -$useDelims)); $this->removeDelimitersBetween($opener, $closer); // The delimiter processor can re-parent the nodes between opener and closer, // so make sure they're contiguous already. Exclusive because we want to keep opener/closer themselves. AdjacentTextMerger::mergeTextNodesBetweenExclusive($openerNode, $closerNode); $delimiterProcessor->process($openerNode, $closerNode, $useDelims); // No delimiter characters left to process, so we can remove delimiter and the now empty node. if ($opener->getLength() === 0) { $this->removeDelimiterAndNode($opener); } // phpcs:disable SlevomatCodingStandard.ControlStructures.EarlyExit.EarlyExitNotUsed if ($closer->getLength() === 0) { $next = $closer->getNext(); $this->removeDelimiterAndNode($closer); $closer = $next; } } // Remove all delimiters $this->removeAll($stackBottom); } } PK ! ���� � Delimiter/Delimiter.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Delimiter; use League\CommonMark\Node\Inline\AbstractStringContainer; final class Delimiter implements DelimiterInterface { /** @psalm-readonly */ private string $char; /** @psalm-readonly-allow-private-mutation */ private int $length; /** @psalm-readonly */ private int $originalLength; /** @psalm-readonly */ private AbstractStringContainer $inlineNode; /** @psalm-readonly-allow-private-mutation */ private ?DelimiterInterface $previous = null; /** @psalm-readonly-allow-private-mutation */ private ?DelimiterInterface $next = null; /** @psalm-readonly */ private bool $canOpen; /** @psalm-readonly */ private bool $canClose; /** @psalm-readonly-allow-private-mutation */ private bool $active; /** @psalm-readonly */ private ?int $index = null; public function __construct(string $char, int $numDelims, AbstractStringContainer $node, bool $canOpen, bool $canClose, ?int $index = null) { $this->char = $char; $this->length = $numDelims; $this->originalLength = $numDelims; $this->inlineNode = $node; $this->canOpen = $canOpen; $this->canClose = $canClose; $this->active = true; $this->index = $index; } public function canClose(): bool { return $this->canClose; } public function canOpen(): bool { return $this->canOpen; } public function isActive(): bool { return $this->active; } public function setActive(bool $active): void { $this->active = $active; } public function getChar(): string { return $this->char; } public function getIndex(): ?int { return $this->index; } public function getNext(): ?DelimiterInterface { return $this->next; } public function setNext(?DelimiterInterface $next): void { $this->next = $next; } public function getLength(): int { return $this->length; } public function setLength(int $length): void { $this->length = $length; } public function getOriginalLength(): int { return $this->originalLength; } public function getInlineNode(): AbstractStringContainer { return $this->inlineNode; } public function getPrevious(): ?DelimiterInterface { return $this->previous; } public function setPrevious(?DelimiterInterface $previous): void { $this->previous = $previous; } } PK ! ��sm� � = Delimiter/Processor/DelimiterProcessorCollectionInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java) * - (c) Atlassian Pty Ltd * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Delimiter\Processor; use League\CommonMark\Exception\InvalidArgumentException; interface DelimiterProcessorCollectionInterface extends \Countable { /** * Add the given delim processor to the collection * * @param DelimiterProcessorInterface $processor The delim processor to add * * @throws InvalidArgumentException Exception will be thrown if attempting to add multiple processors for the same character */ public function add(DelimiterProcessorInterface $processor): void; /** * Returns the delim processor which handles the given character if one exists */ public function getDelimiterProcessor(string $char): ?DelimiterProcessorInterface; /** * Returns an array of delimiter characters who have associated processors * * @return string[] */ public function getDelimiterCharacters(): array; } PK ! a�� 3 Delimiter/Processor/StaggeredDelimiterProcessor.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java) * - (c) Atlassian Pty Ltd * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Delimiter\Processor; use League\CommonMark\Delimiter\DelimiterInterface; use League\CommonMark\Exception\InvalidArgumentException; use League\CommonMark\Node\Inline\AbstractStringContainer; /** * An implementation of DelimiterProcessorInterface that dispatches all calls to two or more other DelimiterProcessors * depending on the length of the delimiter run. All child DelimiterProcessors must have different minimum * lengths. A given delimiter run is dispatched to the child with the largest acceptable minimum length. If no * child is applicable, the one with the largest minimum length is chosen. * * @internal */ final class StaggeredDelimiterProcessor implements DelimiterProcessorInterface { /** @psalm-readonly */ private string $delimiterChar; /** @psalm-readonly-allow-private-mutation */ private int $minLength = 0; /** * @var array<int, DelimiterProcessorInterface>|DelimiterProcessorInterface[] * * @psalm-readonly-allow-private-mutation */ private array $processors = []; // keyed by minLength in reverse order public function __construct(string $char, DelimiterProcessorInterface $processor) { $this->delimiterChar = $char; $this->add($processor); } public function getOpeningCharacter(): string { return $this->delimiterChar; } public function getClosingCharacter(): string { return $this->delimiterChar; } public function getMinLength(): int { return $this->minLength; } /** * Adds the given processor to this staggered delimiter processor * * @throws InvalidArgumentException if attempting to add another processors for the same character and minimum length */ public function add(DelimiterProcessorInterface $processor): void { $len = $processor->getMinLength(); if (isset($this->processors[$len])) { throw new InvalidArgumentException(\sprintf('Cannot add two delimiter processors for char "%s" and minimum length %d', $this->delimiterChar, $len)); } $this->processors[$len] = $processor; \krsort($this->processors); $this->minLength = \min($this->minLength, $len); } public function getDelimiterUse(DelimiterInterface $opener, DelimiterInterface $closer): int { return $this->findProcessor($opener->getLength())->getDelimiterUse($opener, $closer); } public function process(AbstractStringContainer $opener, AbstractStringContainer $closer, int $delimiterUse): void { $this->findProcessor($delimiterUse)->process($opener, $closer, $delimiterUse); } private function findProcessor(int $len): DelimiterProcessorInterface { // Find the "longest" processor which can handle this length foreach ($this->processors as $processor) { if ($processor->getMinLength() <= $len) { return $processor; } } // Just use the first one in our list $first = \reset($this->processors); \assert($first instanceof DelimiterProcessorInterface); return $first; } } PK ! &1F7i i 4 Delimiter/Processor/DelimiterProcessorCollection.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java) * - (c) Atlassian Pty Ltd * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Delimiter\Processor; use League\CommonMark\Exception\InvalidArgumentException; final class DelimiterProcessorCollection implements DelimiterProcessorCollectionInterface { /** * @var array<string,DelimiterProcessorInterface>|DelimiterProcessorInterface[] * * @psalm-readonly-allow-private-mutation */ private array $processorsByChar = []; public function add(DelimiterProcessorInterface $processor): void { $opening = $processor->getOpeningCharacter(); $closing = $processor->getClosingCharacter(); if ($opening === $closing) { $old = $this->processorsByChar[$opening] ?? null; if ($old !== null && $old->getOpeningCharacter() === $old->getClosingCharacter()) { $this->addStaggeredDelimiterProcessorForChar($opening, $old, $processor); } else { $this->addDelimiterProcessorForChar($opening, $processor); } } else { $this->addDelimiterProcessorForChar($opening, $processor); $this->addDelimiterProcessorForChar($closing, $processor); } } public function getDelimiterProcessor(string $char): ?DelimiterProcessorInterface { return $this->processorsByChar[$char] ?? null; } /** * @return string[] */ public function getDelimiterCharacters(): array { return \array_keys($this->processorsByChar); } private function addDelimiterProcessorForChar(string $delimiterChar, DelimiterProcessorInterface $processor): void { if (isset($this->processorsByChar[$delimiterChar])) { throw new InvalidArgumentException(\sprintf('Delim processor for character "%s" already exists', $processor->getOpeningCharacter())); } $this->processorsByChar[$delimiterChar] = $processor; } private function addStaggeredDelimiterProcessorForChar(string $opening, DelimiterProcessorInterface $old, DelimiterProcessorInterface $new): void { if ($old instanceof StaggeredDelimiterProcessor) { $s = $old; } else { $s = new StaggeredDelimiterProcessor($opening, $old); } $s->add($new); $this->processorsByChar[$opening] = $s; } public function count(): int { return \count($this->processorsByChar); } } PK ! pjʥ 3 Delimiter/Processor/DelimiterProcessorInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java) * - (c) Atlassian Pty Ltd * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Delimiter\Processor; use League\CommonMark\Delimiter\DelimiterInterface; use League\CommonMark\Node\Inline\AbstractStringContainer; /** * Interface for a delimiter processor */ interface DelimiterProcessorInterface { /** * Returns the character that marks the beginning of a delimited node. * * This must not clash with any other processors being added to the environment. */ public function getOpeningCharacter(): string; /** * Returns the character that marks the ending of a delimited node. * * This must not clash with any other processors being added to the environment. * * Note that for a symmetric delimiter such as "*", this is the same as the opening. */ public function getClosingCharacter(): string; /** * Minimum number of delimiter characters that are needed to active this. * * Must be at least 1. */ public function getMinLength(): int; /** * Determine how many (if any) of the delimiter characters should be used. * * This allows implementations to decide how many characters to be used * based on the properties of the delimiter runs. An implementation can also * return 0 when it doesn't want to allow this particular combination of * delimiter runs. * * @param DelimiterInterface $opener The opening delimiter run * @param DelimiterInterface $closer The closing delimiter run */ public function getDelimiterUse(DelimiterInterface $opener, DelimiterInterface $closer): int; /** * Process the matched delimiters, e.g. by wrapping the nodes between opener * and closer in a new node, or appending a new node after the opener. * * Note that removal of the delimiter from the delimiter nodes and detaching * them is done by the caller. * * @param AbstractStringContainer $opener The node that contained the opening delimiter * @param AbstractStringContainer $closer The node that contained the closing delimiter * @param int $delimiterUse The number of delimiters that were used */ public function process(AbstractStringContainer $opener, AbstractStringContainer $closer, int $delimiterUse): void; } PK ! R�E� � : Extension/DisallowedRawHtml/DisallowedRawHtmlExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DisallowedRawHtml; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Extension\CommonMark\Node\Block\HtmlBlock; use League\CommonMark\Extension\CommonMark\Node\Inline\HtmlInline; use League\CommonMark\Extension\CommonMark\Renderer\Block\HtmlBlockRenderer; use League\CommonMark\Extension\CommonMark\Renderer\Inline\HtmlInlineRenderer; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; final class DisallowedRawHtmlExtension implements ConfigurableExtensionInterface { private const DEFAULT_DISALLOWED_TAGS = [ 'title', 'textarea', 'style', 'xmp', 'iframe', 'noembed', 'noframes', 'script', 'plaintext', ]; public function configureSchema(ConfigurationBuilderInterface $builder): void { $builder->addSchema('disallowed_raw_html', Expect::structure([ 'disallowed_tags' => Expect::listOf('string')->default(self::DEFAULT_DISALLOWED_TAGS)->mergeDefaults(false), ])); } public function register(EnvironmentBuilderInterface $environment): void { $environment->addRenderer(HtmlBlock::class, new DisallowedRawHtmlRenderer(new HtmlBlockRenderer()), 50); $environment->addRenderer(HtmlInline::class, new DisallowedRawHtmlRenderer(new HtmlInlineRenderer()), 50); } } PK ! j �L� � 9 Extension/DisallowedRawHtml/DisallowedRawHtmlRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DisallowedRawHtml; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class DisallowedRawHtmlRenderer implements NodeRendererInterface, ConfigurationAwareInterface { /** @psalm-readonly */ private NodeRendererInterface $innerRenderer; /** @psalm-readonly-allow-private-mutation */ private ConfigurationInterface $config; public function __construct(NodeRendererInterface $innerRenderer) { $this->innerRenderer = $innerRenderer; } public function render(Node $node, ChildNodeRendererInterface $childRenderer): ?string { $rendered = (string) $this->innerRenderer->render($node, $childRenderer); if ($rendered === '') { return ''; } $tags = (array) $this->config->get('disallowed_raw_html/disallowed_tags'); if (\count($tags) === 0) { return $rendered; } $regex = \sprintf('/<(\/?(?:%s)[ \/>])/i', \implode('|', \array_map('preg_quote', $tags))); // Match these types of tags: <title> </title> <title x="sdf"> <title/> <title /> return \preg_replace($regex, '<$1', $rendered); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; if ($this->innerRenderer instanceof ConfigurationAwareInterface) { $this->innerRenderer->setConfiguration($configuration); } } } PK ! Ȉ�\; ; 1 Extension/Strikethrough/StrikethroughRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> and uAfrica.com (http://uafrica.com) * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Strikethrough; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class StrikethroughRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param Strikethrough $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { Strikethrough::assertInstanceOf($node); return new HtmlElement('del', $node->data->get('attributes'), $childRenderer->renderNodes($node->children())); } public function getXmlTagName(Node $node): string { return 'strikethrough'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } } PK ! �L8y� � ; Extension/Strikethrough/StrikethroughDelimiterProcessor.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> and uAfrica.com (http://uafrica.com) * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Strikethrough; use League\CommonMark\Delimiter\DelimiterInterface; use League\CommonMark\Delimiter\Processor\DelimiterProcessorInterface; use League\CommonMark\Node\Inline\AbstractStringContainer; final class StrikethroughDelimiterProcessor implements DelimiterProcessorInterface { public function getOpeningCharacter(): string { return '~'; } public function getClosingCharacter(): string { return '~'; } public function getMinLength(): int { return 1; } public function getDelimiterUse(DelimiterInterface $opener, DelimiterInterface $closer): int { if ($opener->getLength() > 2 && $closer->getLength() > 2) { return 0; } if ($opener->getLength() !== $closer->getLength()) { return 0; } return \min($opener->getLength(), $closer->getLength()); } public function process(AbstractStringContainer $opener, AbstractStringContainer $closer, int $delimiterUse): void { $strikethrough = new Strikethrough(\str_repeat('~', $delimiterUse)); $tmp = $opener->next(); while ($tmp !== null && $tmp !== $closer) { $next = $tmp->next(); $strikethrough->appendChild($tmp); $tmp = $next; } $opener->insertAfter($strikethrough); } } PK ! �}��' ' 2 Extension/Strikethrough/StrikethroughExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> and uAfrica.com (http://uafrica.com) * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Strikethrough; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Extension\ExtensionInterface; final class StrikethroughExtension implements ExtensionInterface { public function register(EnvironmentBuilderInterface $environment): void { $environment->addDelimiterProcessor(new StrikethroughDelimiterProcessor()); $environment->addRenderer(Strikethrough::class, new StrikethroughRenderer()); } } PK ! Y6�� � ) Extension/Strikethrough/Strikethrough.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> and uAfrica.com (http://uafrica.com) * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Strikethrough; use League\CommonMark\Node\Inline\AbstractInline; use League\CommonMark\Node\Inline\DelimitedInterface; final class Strikethrough extends AbstractInline implements DelimitedInterface { private string $delimiter; public function __construct(string $delimiter = '~~') { parent::__construct(); $this->delimiter = $delimiter; } public function getOpeningDelimiter(): string { return $this->delimiter; } public function getClosingDelimiter(): string { return $this->delimiter; } } PK ! ^M`8 8 Extension/Embed/EmbedParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Embed; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; class EmbedParser implements BlockContinueParserInterface { private Embed $embed; public function __construct(string $url) { $this->embed = new Embed($url); } public function getBlock(): AbstractBlock { return $this->embed; } public function isContainer(): bool { return false; } public function canHaveLazyContinuationLines(): bool { return false; } public function canContain(AbstractBlock $childBlock): bool { return false; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { return BlockContinue::none(); } public function addLine(string $line): void { } public function closeBlock(): void { } } PK ! ��� " Extension/Embed/EmbedProcessor.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Embed; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\CommonMark\Node\Inline\Link; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Node\NodeIterator; final class EmbedProcessor { public const FALLBACK_REMOVE = 'remove'; public const FALLBACK_LINK = 'link'; private EmbedAdapterInterface $adapter; private string $fallback; public function __construct(EmbedAdapterInterface $adapter, string $fallback = self::FALLBACK_REMOVE) { $this->adapter = $adapter; $this->fallback = $fallback; } public function __invoke(DocumentParsedEvent $event): void { $document = $event->getDocument(); $embeds = []; foreach (new NodeIterator($document) as $node) { if (! ($node instanceof Embed)) { continue; } if ($node->parent() !== $document) { $replacement = new Paragraph(); $replacement->appendChild(new Text($node->getUrl())); $node->replaceWith($replacement); } else { $embeds[] = $node; } } $this->adapter->updateEmbeds($embeds); foreach ($embeds as $embed) { if ($embed->getEmbedCode() !== null) { continue; } if ($this->fallback === self::FALLBACK_REMOVE) { $embed->detach(); } elseif ($this->fallback === self::FALLBACK_LINK) { $paragraph = new Paragraph(); $paragraph->appendChild(new Link($embed->getUrl(), $embed->getUrl())); $embed->replaceWith($paragraph); } } } } PK ! * x� � $ Extension/Embed/EmbedStartParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Embed; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; use League\CommonMark\Util\LinkParserHelper; class EmbedStartParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { if ($cursor->isIndented() || $parserState->getParagraphContent() !== null || ! ($parserState->getActiveBlockParser()->isContainer())) { return BlockStart::none(); } // 0-3 leading spaces are okay $cursor->advanceToNextNonSpaceOrTab(); // The line must begin with "https://" if (! str_starts_with($cursor->getRemainder(), 'https://')) { return BlockStart::none(); } // A valid link must be found next if (($dest = LinkParserHelper::parseLinkDestination($cursor)) === null) { return BlockStart::none(); } // Skip any trailing whitespace $cursor->advanceToNextNonSpaceOrTab(); // We must be at the end of the line; otherwise, this link was not by itself if (! $cursor->isAtEnd()) { return BlockStart::none(); } return BlockStart::of(new EmbedParser($dest))->at($cursor); } } PK ! F#�( ( ) Extension/Embed/EmbedAdapterInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Embed; /** * Interface for a service which updates the embed code(s) for the given array of embeds */ interface EmbedAdapterInterface { /** * @param Embed[] $embeds */ public function updateEmbeds(array $embeds): void; } PK ! �a*B B ! Extension/Embed/EmbedRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Embed; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; class EmbedRenderer implements NodeRendererInterface { /** * @param Embed $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer) { Embed::assertInstanceOf($node); return $node->getEmbedCode() ?? ''; } } PK ! �*M�� � " Extension/Embed/EmbedExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Embed; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; final class EmbedExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $builder->addSchema('embed', Expect::structure([ 'adapter' => Expect::type(EmbedAdapterInterface::class), 'allowed_domains' => Expect::arrayOf('string')->default([]), 'fallback' => Expect::anyOf('link', 'remove')->default('link'), ])); } public function register(EnvironmentBuilderInterface $environment): void { $adapter = $environment->getConfiguration()->get('embed.adapter'); \assert($adapter instanceof EmbedAdapterInterface); $allowedDomains = $environment->getConfiguration()->get('embed.allowed_domains'); if ($allowedDomains !== []) { $adapter = new DomainFilteringAdapter($adapter, $allowedDomains); } $environment ->addBlockStartParser(new EmbedStartParser(), 300) ->addEventListener(DocumentParsedEvent::class, new EmbedProcessor($adapter, $environment->getConfiguration()->get('embed.fallback')), 1010) ->addRenderer(Embed::class, new EmbedRenderer()); } } PK ! ht t * Extension/Embed/DomainFilteringAdapter.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Embed; class DomainFilteringAdapter implements EmbedAdapterInterface { private EmbedAdapterInterface $decorated; /** @psalm-var non-empty-string */ private string $regex; /** * @param string[] $allowedDomains */ public function __construct(EmbedAdapterInterface $decorated, array $allowedDomains) { $this->decorated = $decorated; $this->regex = self::createRegex($allowedDomains); } /** * {@inheritDoc} */ public function updateEmbeds(array $embeds): void { $this->decorated->updateEmbeds(\array_values(\array_filter($embeds, function (Embed $embed): bool { return \preg_match($this->regex, $embed->getUrl()) === 1; }))); } /** * @param string[] $allowedDomains * * @psalm-return non-empty-string */ private static function createRegex(array $allowedDomains): string { $allowedDomains = \array_map('preg_quote', $allowedDomains); return '/^(?:https?:\/\/)?(?:[^.]+\.)*(' . \implode('|', $allowedDomains) . ')/'; } } PK ! ��⤞ � 1 Extension/Embed/Bridge/OscaroteroEmbedAdapter.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Embed\Bridge; use Embed\Embed as EmbedLib; use League\CommonMark\Exception\MissingDependencyException; use League\CommonMark\Extension\Embed\Embed; use League\CommonMark\Extension\Embed\EmbedAdapterInterface; final class OscaroteroEmbedAdapter implements EmbedAdapterInterface { private EmbedLib $embedLib; public function __construct(?EmbedLib $embed = null) { if ($embed === null) { if (! \class_exists(EmbedLib::class)) { throw new MissingDependencyException('The embed/embed package is not installed. Please install it with Composer to use this adapter.'); } $embed = new EmbedLib(); } $this->embedLib = $embed; } /** * {@inheritDoc} */ public function updateEmbeds(array $embeds): void { $extractors = $this->embedLib->getMulti(...\array_map(static fn (Embed $embed) => $embed->getUrl(), $embeds)); foreach ($extractors as $i => $extractor) { if ($extractor->code !== null) { $embeds[$i]->setEmbedCode($extractor->code->html); } } } } PK ! � � Extension/Embed/Embed.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Embed; use League\CommonMark\Node\Block\AbstractBlock; final class Embed extends AbstractBlock { private string $url; private ?string $embedCode; public function __construct(string $url, ?string $embedCode = null) { parent::__construct(); $this->url = $url; $this->embedCode = $embedCode; } public function getUrl(): string { return $this->url; } public function setUrl(string $url): void { $this->url = $url; } public function getEmbedCode(): ?string { return $this->embedCode; } public function setEmbedCode(?string $embedCode): void { $this->embedCode = $embedCode; } } PK ! 5$ � � ? Extension/FrontMatter/Exception/InvalidFrontMatterException.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\FrontMatter\Exception; use League\CommonMark\Exception\CommonMarkException; class InvalidFrontMatterException extends \RuntimeException implements CommonMarkException { public static function wrap(\Throwable $t): self { return new InvalidFrontMatterException('Failed to parse front matter: ' . $t->getMessage(), 0, $t); } } PK ! �cֿ � 6 Extension/FrontMatter/FrontMatterProviderInterface.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\FrontMatter; interface FrontMatterProviderInterface { /** * @return mixed|null */ public function getFrontMatter(); } PK ! �iҍ' ' + Extension/FrontMatter/FrontMatterParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\FrontMatter; use League\CommonMark\Extension\FrontMatter\Data\FrontMatterDataParserInterface; use League\CommonMark\Extension\FrontMatter\Exception\InvalidFrontMatterException; use League\CommonMark\Extension\FrontMatter\Input\MarkdownInputWithFrontMatter; use League\CommonMark\Parser\Cursor; final class FrontMatterParser implements FrontMatterParserInterface { /** @psalm-readonly */ private FrontMatterDataParserInterface $frontMatterParser; private const REGEX_FRONT_MATTER = '/^---\\R.*?\\R---\\R/s'; public function __construct(FrontMatterDataParserInterface $frontMatterParser) { $this->frontMatterParser = $frontMatterParser; } /** * @throws InvalidFrontMatterException if the front matter cannot be parsed */ public function parse(string $markdownContent): MarkdownInputWithFrontMatter { $cursor = new Cursor($markdownContent); // Locate the front matter $frontMatter = $cursor->match(self::REGEX_FRONT_MATTER); if ($frontMatter === null) { return new MarkdownInputWithFrontMatter($markdownContent); } // Trim the last line (ending ---s and newline) $frontMatter = \preg_replace('/---\R$/', '', $frontMatter); if ($frontMatter === null) { return new MarkdownInputWithFrontMatter($markdownContent); } // Parse the resulting YAML data $data = $this->frontMatterParser->parse($frontMatter); // Advance through any remaining newlines which separated the front matter from the Markdown text $trailingNewlines = $cursor->match('/^\R+/'); // Calculate how many lines the Markdown is offset from the front matter by counting the number of newlines // Don't forget to add 1 because we stripped one out when trimming the trailing delims $lineOffset = \preg_match_all('/\R/', $frontMatter . $trailingNewlines) + 1; return new MarkdownInputWithFrontMatter($cursor->getRemainder(), $lineOffset, $data); } } PK ! j�@� � 7 Extension/FrontMatter/Data/LibYamlFrontMatterParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\FrontMatter\Data; use League\CommonMark\Exception\MissingDependencyException; use League\CommonMark\Extension\FrontMatter\Exception\InvalidFrontMatterException; final class LibYamlFrontMatterParser implements FrontMatterDataParserInterface { public static function capable(): ?LibYamlFrontMatterParser { if (! \extension_loaded('yaml')) { return null; } return new LibYamlFrontMatterParser(); } /** * {@inheritDoc} */ public function parse(string $frontMatter) { if (! \extension_loaded('yaml')) { throw new MissingDependencyException('Failed to parse yaml: "ext-yaml" extension is missing'); } $result = @\yaml_parse($frontMatter); if ($result === false) { throw new InvalidFrontMatterException('Failed to parse front matter'); } return $result; } } PK ! C���� � = Extension/FrontMatter/Data/FrontMatterDataParserInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\FrontMatter\Data; use League\CommonMark\Extension\FrontMatter\Exception\InvalidFrontMatterException; interface FrontMatterDataParserInterface { /** * @return mixed|null The parsed data (which may be null, if the input represents a null value) * * @throws InvalidFrontMatterException if parsing fails */ public function parse(string $frontMatter); } PK ! ��a a ; Extension/FrontMatter/Data/SymfonyYamlFrontMatterParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\FrontMatter\Data; use League\CommonMark\Exception\MissingDependencyException; use League\CommonMark\Extension\FrontMatter\Exception\InvalidFrontMatterException; use Symfony\Component\Yaml\Exception\ParseException; use Symfony\Component\Yaml\Yaml; final class SymfonyYamlFrontMatterParser implements FrontMatterDataParserInterface { /** * {@inheritDoc} */ public function parse(string $frontMatter) { if (! \class_exists(Yaml::class)) { throw new MissingDependencyException('Failed to parse yaml: "symfony/yaml" library is missing'); } try { /** @psalm-suppress ReservedWord */ return Yaml::parse($frontMatter); } catch (ParseException $ex) { throw InvalidFrontMatterException::wrap($ex); } } } PK ! NY �� � ? Extension/FrontMatter/Output/RenderedContentWithFrontMatter.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\FrontMatter\Output; use League\CommonMark\Extension\FrontMatter\FrontMatterProviderInterface; use League\CommonMark\Node\Block\Document; use League\CommonMark\Output\RenderedContent; /** * @psalm-immutable */ final class RenderedContentWithFrontMatter extends RenderedContent implements FrontMatterProviderInterface { /** * @var mixed * * @psalm-readonly */ private $frontMatter; /** * @param Document $document The parsed Document object * @param string $content The final HTML * @param mixed|null $frontMatter Any parsed front matter */ public function __construct(Document $document, string $content, $frontMatter) { parent::__construct($document, $content); $this->frontMatter = $frontMatter; } /** * {@inheritDoc} */ public function getFrontMatter() { return $this->frontMatter; } } PK ! ��� � < Extension/FrontMatter/Input/MarkdownInputWithFrontMatter.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\FrontMatter\Input; use League\CommonMark\Extension\FrontMatter\FrontMatterProviderInterface; use League\CommonMark\Input\MarkdownInput; final class MarkdownInputWithFrontMatter extends MarkdownInput implements FrontMatterProviderInterface { /** @var mixed|null */ private $frontMatter; /** * @param string $content Markdown content without the raw front matter * @param int $lineOffset Line offset (based on number of front matter lines removed) * @param mixed|null $frontMatter Parsed front matter */ public function __construct(string $content, int $lineOffset = 0, $frontMatter = null) { parent::__construct($content, $lineOffset); $this->frontMatter = $frontMatter; } /** * {@inheritDoc} */ public function getFrontMatter() { return $this->frontMatter; } } PK ! �d�s� � @ Extension/FrontMatter/Listener/FrontMatterPostRenderListener.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\FrontMatter\Listener; use League\CommonMark\Event\DocumentRenderedEvent; use League\CommonMark\Extension\FrontMatter\Output\RenderedContentWithFrontMatter; final class FrontMatterPostRenderListener { public function __invoke(DocumentRenderedEvent $event): void { if ($event->getOutput()->getDocument()->data->get('front_matter', null) === null) { return; } $frontMatter = $event->getOutput()->getDocument()->data->get('front_matter'); $event->replaceOutput(new RenderedContentWithFrontMatter( $event->getOutput()->getDocument(), $event->getOutput()->getContent(), $frontMatter )); } } PK ! 6��E� � 7 Extension/FrontMatter/Listener/FrontMatterPreParser.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\FrontMatter\Listener; use League\CommonMark\Event\DocumentPreParsedEvent; use League\CommonMark\Extension\FrontMatter\FrontMatterParserInterface; final class FrontMatterPreParser { private FrontMatterParserInterface $parser; public function __construct(FrontMatterParserInterface $parser) { $this->parser = $parser; } public function __invoke(DocumentPreParsedEvent $event): void { $content = $event->getMarkdown()->getContent(); $parsed = $this->parser->parse($content); $event->getDocument()->data->set('front_matter', $parsed->getFrontMatter()); $event->replaceMarkdown($parsed); } } PK ! �Oj� � . Extension/FrontMatter/FrontMatterExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\FrontMatter; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Event\DocumentPreParsedEvent; use League\CommonMark\Event\DocumentRenderedEvent; use League\CommonMark\Extension\ExtensionInterface; use League\CommonMark\Extension\FrontMatter\Data\FrontMatterDataParserInterface; use League\CommonMark\Extension\FrontMatter\Data\LibYamlFrontMatterParser; use League\CommonMark\Extension\FrontMatter\Data\SymfonyYamlFrontMatterParser; use League\CommonMark\Extension\FrontMatter\Listener\FrontMatterPostRenderListener; use League\CommonMark\Extension\FrontMatter\Listener\FrontMatterPreParser; final class FrontMatterExtension implements ExtensionInterface { /** @psalm-readonly */ private FrontMatterParserInterface $frontMatterParser; public function __construct(?FrontMatterDataParserInterface $dataParser = null) { $this->frontMatterParser = new FrontMatterParser($dataParser ?? LibYamlFrontMatterParser::capable() ?? new SymfonyYamlFrontMatterParser()); } public function getFrontMatterParser(): FrontMatterParserInterface { return $this->frontMatterParser; } public function register(EnvironmentBuilderInterface $environment): void { $environment->addEventListener(DocumentPreParsedEvent::class, new FrontMatterPreParser($this->frontMatterParser)); $environment->addEventListener(DocumentRenderedEvent::class, new FrontMatterPostRenderListener(), -500); } } PK ! R)n 4 Extension/FrontMatter/FrontMatterParserInterface.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\FrontMatter; use League\CommonMark\Extension\FrontMatter\Input\MarkdownInputWithFrontMatter; interface FrontMatterParserInterface { public function parse(string $markdownContent): MarkdownInputWithFrontMatter; } PK ! �1'� � ' Extension/InlinesOnly/ChildRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\InlinesOnly; use League\CommonMark\Node\Block\Document; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; /** * Simply renders child elements as-is, adding newlines as needed. */ final class ChildRenderer implements NodeRendererInterface { public function render(Node $node, ChildNodeRendererInterface $childRenderer): string { $out = $childRenderer->renderNodes($node->children()); if (! $node instanceof Document) { $out .= $childRenderer->getBlockSeparator(); } return $out; } } PK ! t�~�� � . Extension/InlinesOnly/InlinesOnlyExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\InlinesOnly; use League\CommonMark as Core; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Extension\CommonMark; use League\CommonMark\Extension\CommonMark\Delimiter\Processor\EmphasisDelimiterProcessor; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; final class InlinesOnlyExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $builder->addSchema('commonmark', Expect::structure([ 'use_asterisk' => Expect::bool(true), 'use_underscore' => Expect::bool(true), 'enable_strong' => Expect::bool(true), 'enable_em' => Expect::bool(true), ])); } // phpcs:disable Generic.Functions.FunctionCallArgumentSpacing.TooMuchSpaceAfterComma,Squiz.WhiteSpace.SemicolonSpacing.Incorrect public function register(EnvironmentBuilderInterface $environment): void { $childRenderer = new ChildRenderer(); $environment ->addInlineParser(new Core\Parser\Inline\NewlineParser(), 200) ->addInlineParser(new CommonMark\Parser\Inline\BacktickParser(), 150) ->addInlineParser(new CommonMark\Parser\Inline\EscapableParser(), 80) ->addInlineParser(new CommonMark\Parser\Inline\EntityParser(), 70) ->addInlineParser(new CommonMark\Parser\Inline\AutolinkParser(), 50) ->addInlineParser(new CommonMark\Parser\Inline\HtmlInlineParser(), 40) ->addInlineParser(new CommonMark\Parser\Inline\CloseBracketParser(), 30) ->addInlineParser(new CommonMark\Parser\Inline\OpenBracketParser(), 20) ->addInlineParser(new CommonMark\Parser\Inline\BangParser(), 10) ->addRenderer(Core\Node\Block\Document::class, $childRenderer, 0) ->addRenderer(Core\Node\Block\Paragraph::class, $childRenderer, 0) ->addRenderer(CommonMark\Node\Inline\Code::class, new CommonMark\Renderer\Inline\CodeRenderer(), 0) ->addRenderer(CommonMark\Node\Inline\Emphasis::class, new CommonMark\Renderer\Inline\EmphasisRenderer(), 0) ->addRenderer(CommonMark\Node\Inline\HtmlInline::class, new CommonMark\Renderer\Inline\HtmlInlineRenderer(), 0) ->addRenderer(CommonMark\Node\Inline\Image::class, new CommonMark\Renderer\Inline\ImageRenderer(), 0) ->addRenderer(CommonMark\Node\Inline\Link::class, new CommonMark\Renderer\Inline\LinkRenderer(), 0) ->addRenderer(Core\Node\Inline\Newline::class, new Core\Renderer\Inline\NewlineRenderer(), 0) ->addRenderer(CommonMark\Node\Inline\Strong::class, new CommonMark\Renderer\Inline\StrongRenderer(), 0) ->addRenderer(Core\Node\Inline\Text::class, new Core\Renderer\Inline\TextRenderer(), 0) ; if ($environment->getConfiguration()->get('commonmark/use_asterisk')) { $environment->addDelimiterProcessor(new EmphasisDelimiterProcessor('*')); } if ($environment->getConfiguration()->get('commonmark/use_underscore')) { $environment->addDelimiterProcessor(new EmphasisDelimiterProcessor('_')); } } } PK ! ��T/� � # Extension/Mention/MentionParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Mention; use League\CommonMark\Extension\Mention\Generator\CallbackGenerator; use League\CommonMark\Extension\Mention\Generator\MentionGeneratorInterface; use League\CommonMark\Extension\Mention\Generator\StringTemplateLinkGenerator; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; final class MentionParser implements InlineParserInterface { /** @psalm-readonly */ private string $name; /** @psalm-readonly */ private string $prefix; /** @psalm-readonly */ private string $identifierPattern; /** @psalm-readonly */ private MentionGeneratorInterface $mentionGenerator; public function __construct(string $name, string $prefix, string $identifierPattern, MentionGeneratorInterface $mentionGenerator) { $this->name = $name; $this->prefix = $prefix; $this->identifierPattern = $identifierPattern; $this->mentionGenerator = $mentionGenerator; } public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::join( InlineParserMatch::string($this->prefix), InlineParserMatch::regex($this->identifierPattern) ); } public function parse(InlineParserContext $inlineContext): bool { $cursor = $inlineContext->getCursor(); // The prefix must not have any other characters immediately prior $previousChar = $cursor->peek(-1); if ($previousChar !== null && \preg_match('/\w/', $previousChar)) { // peek() doesn't modify the cursor, so no need to restore state first return false; } [$prefix, $identifier] = $inlineContext->getSubMatches(); $mention = $this->mentionGenerator->generateMention(new Mention($this->name, $prefix, $identifier)); if ($mention === null) { return false; } $cursor->advanceBy($inlineContext->getFullMatchLength()); $inlineContext->getContainer()->appendChild($mention); return true; } public static function createWithStringTemplate(string $name, string $prefix, string $mentionRegex, string $urlTemplate): MentionParser { return new self($name, $prefix, $mentionRegex, new StringTemplateLinkGenerator($urlTemplate)); } public static function createWithCallback(string $name, string $prefix, string $mentionRegex, callable $callback): MentionParser { return new self($name, $prefix, $mentionRegex, new CallbackGenerator($callback)); } } PK ! �U|� 9 Extension/Mention/Generator/MentionGeneratorInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Mention\Generator; use League\CommonMark\Extension\Mention\Mention; use League\CommonMark\Node\Inline\AbstractInline; interface MentionGeneratorInterface { public function generateMention(Mention $mention): ?AbstractInline; } PK ! �ݖN N ; Extension/Mention/Generator/StringTemplateLinkGenerator.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Mention\Generator; use League\CommonMark\Extension\Mention\Mention; use League\CommonMark\Node\Inline\AbstractInline; final class StringTemplateLinkGenerator implements MentionGeneratorInterface { private string $urlTemplate; public function __construct(string $urlTemplate) { $this->urlTemplate = $urlTemplate; } public function generateMention(Mention $mention): ?AbstractInline { $mention->setUrl(\sprintf($this->urlTemplate, $mention->getIdentifier())); return $mention; } } PK ! �G��G G 1 Extension/Mention/Generator/CallbackGenerator.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Mention\Generator; use League\CommonMark\Exception\LogicException; use League\CommonMark\Extension\Mention\Mention; use League\CommonMark\Node\Inline\AbstractInline; final class CallbackGenerator implements MentionGeneratorInterface { /** * A callback function which sets the URL on the passed mention and returns the mention, return a new AbstractInline based object or null if the mention is not a match * * @var callable(Mention): ?AbstractInline */ private $callback; public function __construct(callable $callback) { $this->callback = $callback; } /** * @throws LogicException */ public function generateMention(Mention $mention): ?AbstractInline { $result = \call_user_func($this->callback, $mention); if ($result === null) { return null; } if ($result instanceof AbstractInline && ! ($result instanceof Mention)) { return $result; } if ($result instanceof Mention && $result->hasUrl()) { return $mention; } throw new LogicException('CallbackGenerator callable must set the URL on the passed mention and return the mention, return a new AbstractInline based object or null if the mention is not a match'); } } PK ! �F� Extension/Mention/Mention.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Mention; use League\CommonMark\Extension\CommonMark\Node\Inline\Link; use League\CommonMark\Node\Inline\Text; class Mention extends Link { private string $name; private string $prefix; private string $identifier; public function __construct(string $name, string $prefix, string $identifier, ?string $label = null) { $this->name = $name; $this->prefix = $prefix; $this->identifier = $identifier; parent::__construct('', $label ?? \sprintf('%s%s', $prefix, $identifier)); } public function getLabel(): ?string { if (($labelNode = $this->findLabelNode()) === null) { return null; } return $labelNode->getLiteral(); } public function getIdentifier(): string { return $this->identifier; } public function getName(): ?string { return $this->name; } public function getPrefix(): string { return $this->prefix; } public function hasUrl(): bool { return $this->url !== ''; } /** * @return $this */ public function setLabel(string $label): self { if (($labelNode = $this->findLabelNode()) === null) { $labelNode = new Text(); $this->prependChild($labelNode); } $labelNode->setLiteral($label); return $this; } private function findLabelNode(): ?Text { foreach ($this->children() as $child) { if ($child instanceof Text) { return $child; } } return null; } } PK ! <@�(� � & Extension/Mention/MentionExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Mention; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\CommonMark\Extension\Mention\Generator\MentionGeneratorInterface; use League\Config\ConfigurationBuilderInterface; use League\Config\Exception\InvalidConfigurationException; use Nette\Schema\Expect; final class MentionExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $isAValidPartialRegex = static function (string $regex): bool { $regex = '/' . $regex . '/i'; return @\preg_match($regex, '') !== false; }; $builder->addSchema('mentions', Expect::arrayOf( Expect::structure([ 'prefix' => Expect::string()->required(), 'pattern' => Expect::string()->assert($isAValidPartialRegex, 'Pattern must not include starting/ending delimiters (like "/")')->required(), 'generator' => Expect::anyOf( Expect::type(MentionGeneratorInterface::class), Expect::string(), Expect::type('callable') )->required(), ]) )); } public function register(EnvironmentBuilderInterface $environment): void { $mentions = $environment->getConfiguration()->get('mentions'); foreach ($mentions as $name => $mention) { if ($mention['generator'] instanceof MentionGeneratorInterface) { $environment->addInlineParser(new MentionParser($name, $mention['prefix'], $mention['pattern'], $mention['generator'])); } elseif (\is_string($mention['generator'])) { $environment->addInlineParser(MentionParser::createWithStringTemplate($name, $mention['prefix'], $mention['pattern'], $mention['generator'])); } elseif (\is_callable($mention['generator'])) { $environment->addInlineParser(MentionParser::createWithCallback($name, $mention['prefix'], $mention['pattern'], $mention['generator'])); } else { throw new InvalidConfigurationException(\sprintf('The "generator" provided for the "%s" MentionParser configuration must be a string template, callable, or an object that implements %s.', $name, MentionGeneratorInterface::class)); } } } } PK ! G , Extension/ConfigurableExtensionInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension; use League\Config\ConfigurationBuilderInterface; interface ConfigurableExtensionInterface extends ExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void; } PK ! �2n�� � $ Extension/Table/TableRowRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This is part of the league/commonmark package. * * (c) Martin Hasoň <martin.hason@gmail.com> * (c) Webuni s.r.o. <info@webuni.cz> * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Table; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class TableRowRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param TableRow $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { TableRow::assertInstanceOf($node); $attrs = $node->data->get('attributes'); $separator = $childRenderer->getInnerSeparator(); return new HtmlElement('tr', $attrs, $separator . $childRenderer->renderNodes($node->children()) . $separator); } public function getXmlTagName(Node $node): string { return 'table_row'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } } PK ! �A�9 9 % Extension/Table/TableCellRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This is part of the league/commonmark package. * * (c) Martin Hasoň <martin.hason@gmail.com> * (c) Webuni s.r.o. <info@webuni.cz> * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Table; use League\CommonMark\Extension\Attributes\Util\AttributesHelper; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class TableCellRenderer implements NodeRendererInterface, XmlNodeRendererInterface { private const DEFAULT_ATTRIBUTES = [ TableCell::ALIGN_LEFT => ['align' => 'left'], TableCell::ALIGN_CENTER => ['align' => 'center'], TableCell::ALIGN_RIGHT => ['align' => 'right'], ]; /** @var array<TableCell::ALIGN_*, array<string, string|string[]|bool>> */ private array $alignmentAttributes; /** * @param array<TableCell::ALIGN_*, array<string, string|string[]|bool>> $alignmentAttributes */ public function __construct(array $alignmentAttributes = self::DEFAULT_ATTRIBUTES) { $this->alignmentAttributes = $alignmentAttributes; } /** * @param TableCell $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { TableCell::assertInstanceOf($node); $attrs = $node->data->get('attributes'); if (($alignment = $node->getAlign()) !== null) { $attrs = AttributesHelper::mergeAttributes($attrs, $this->alignmentAttributes[$alignment]); } $tag = $node->getType() === TableCell::TYPE_HEADER ? 'th' : 'td'; return new HtmlElement($tag, $attrs, $childRenderer->renderNodes($node->children())); } public function getXmlTagName(Node $node): string { return 'table_cell'; } /** * @param TableCell $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { TableCell::assertInstanceOf($node); $ret = ['type' => $node->getType()]; if (($align = $node->getAlign()) !== null) { $ret['align'] = $align; } return $ret; } } PK ! _ �%� � Extension/Table/TableCell.phpnu ȯ�� <?php declare(strict_types=1); /* * This is part of the league/commonmark package. * * (c) Martin Hasoň <martin.hason@gmail.com> * (c) Webuni s.r.o. <info@webuni.cz> * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Table; use League\CommonMark\Node\Block\AbstractBlock; final class TableCell extends AbstractBlock { public const TYPE_HEADER = 'header'; public const TYPE_DATA = 'data'; public const ALIGN_LEFT = 'left'; public const ALIGN_RIGHT = 'right'; public const ALIGN_CENTER = 'center'; /** * @psalm-var self::TYPE_* * @phpstan-var self::TYPE_* * * @psalm-readonly-allow-private-mutation */ private string $type = self::TYPE_DATA; /** * @psalm-var self::ALIGN_*|null * @phpstan-var self::ALIGN_*|null * * @psalm-readonly-allow-private-mutation */ private ?string $align = null; /** * @psalm-param self::TYPE_* $type * @psalm-param self::ALIGN_*|null $align * * @phpstan-param self::TYPE_* $type * @phpstan-param self::ALIGN_*|null $align */ public function __construct(string $type = self::TYPE_DATA, ?string $align = null) { parent::__construct(); $this->type = $type; $this->align = $align; } /** * @psalm-return self::TYPE_* * * @phpstan-return self::TYPE_* */ public function getType(): string { return $this->type; } /** * @psalm-param self::TYPE_* $type * * @phpstan-param self::TYPE_* $type */ public function setType(string $type): void { $this->type = $type; } /** * @psalm-return self::ALIGN_*|null * * @phpstan-return self::ALIGN_*|null */ public function getAlign(): ?string { return $this->align; } /** * @psalm-param self::ALIGN_*|null $align * * @phpstan-param self::ALIGN_*|null $align */ public function setAlign(?string $align): void { $this->align = $align; } } PK ! � �- - ( Extension/Table/TableSectionRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This is part of the league/commonmark package. * * (c) Martin Hasoň <martin.hason@gmail.com> * (c) Webuni s.r.o. <info@webuni.cz> * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Table; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class TableSectionRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param TableSection $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer) { TableSection::assertInstanceOf($node); if (! $node->hasChildren()) { return ''; } $attrs = $node->data->get('attributes'); $separator = $childRenderer->getInnerSeparator(); $tag = $node->getType() === TableSection::TYPE_HEAD ? 'thead' : 'tbody'; return new HtmlElement($tag, $attrs, $separator . $childRenderer->renderNodes($node->children()) . $separator); } public function getXmlTagName(Node $node): string { return 'table_section'; } /** * @param TableSection $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { TableSection::assertInstanceOf($node); return [ 'type' => $node->getType(), ]; } } PK ! �P�8 8 Extension/Table/TableParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This is part of the league/commonmark package. * * (c) Martin Hasoň <martin.hason@gmail.com> * (c) Webuni s.r.o. <info@webuni.cz> * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Table; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Block\BlockContinueParserWithInlinesInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\InlineParserEngineInterface; use League\CommonMark\Util\ArrayCollection; final class TableParser extends AbstractBlockContinueParser implements BlockContinueParserWithInlinesInterface { /** @psalm-readonly */ private Table $block; /** * @var ArrayCollection<string> * * @psalm-readonly-allow-private-mutation */ private ArrayCollection $bodyLines; /** * @var array<int, string|null> * @psalm-var array<int, TableCell::ALIGN_*|null> * @phpstan-var array<int, TableCell::ALIGN_*|null> * * @psalm-readonly */ private array $columns; /** * @var array<int, string> * * @psalm-readonly-allow-private-mutation */ private array $headerCells; /** @psalm-readonly-allow-private-mutation */ private bool $nextIsSeparatorLine = true; /** * @param array<int, string|null> $columns * @param array<int, string> $headerCells * * @psalm-param array<int, TableCell::ALIGN_*|null> $columns * * @phpstan-param array<int, TableCell::ALIGN_*|null> $columns */ public function __construct(array $columns, array $headerCells) { $this->block = new Table(); $this->bodyLines = new ArrayCollection(); $this->columns = $columns; $this->headerCells = $headerCells; } public function canHaveLazyContinuationLines(): bool { return true; } public function getBlock(): Table { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { if (\strpos($cursor->getLine(), '|') === false) { return BlockContinue::none(); } return BlockContinue::at($cursor); } public function addLine(string $line): void { if ($this->nextIsSeparatorLine) { $this->nextIsSeparatorLine = false; } else { $this->bodyLines[] = $line; } } public function parseInlines(InlineParserEngineInterface $inlineParser): void { $headerColumns = \count($this->headerCells); $head = new TableSection(TableSection::TYPE_HEAD); $this->block->appendChild($head); $headerRow = new TableRow(); $head->appendChild($headerRow); for ($i = 0; $i < $headerColumns; $i++) { $cell = $this->headerCells[$i]; $tableCell = $this->parseCell($cell, $i, $inlineParser); $tableCell->setType(TableCell::TYPE_HEADER); $headerRow->appendChild($tableCell); } $body = null; foreach ($this->bodyLines as $rowLine) { $cells = self::split($rowLine); $row = new TableRow(); // Body can not have more columns than head for ($i = 0; $i < $headerColumns; $i++) { $cell = $cells[$i] ?? ''; $tableCell = $this->parseCell($cell, $i, $inlineParser); $row->appendChild($tableCell); } if ($body === null) { // It's valid to have a table without body. In that case, don't add an empty TableBody node. $body = new TableSection(); $this->block->appendChild($body); } $body->appendChild($row); } } private function parseCell(string $cell, int $column, InlineParserEngineInterface $inlineParser): TableCell { $tableCell = new TableCell(); if ($column < \count($this->columns)) { $tableCell->setAlign($this->columns[$column]); } $inlineParser->parse(\trim($cell), $tableCell); return $tableCell; } /** * @internal * * @return array<int, string> */ public static function split(string $line): array { $cursor = new Cursor(\trim($line)); if ($cursor->getCurrentCharacter() === '|') { $cursor->advanceBy(1); } $cells = []; $sb = ''; while (! $cursor->isAtEnd()) { switch ($c = $cursor->getCurrentCharacter()) { case '\\': if ($cursor->peek() === '|') { // Pipe is special for table parsing. An escaped pipe doesn't result in a new cell, but is // passed down to inline parsing as an unescaped pipe. Note that that applies even for the `\|` // in an input like `\\|` - in other words, table parsing doesn't support escaping backslashes. $sb .= '|'; $cursor->advanceBy(1); } else { // Preserve backslash before other characters or at end of line. $sb .= '\\'; } break; case '|': $cells[] = $sb; $sb = ''; break; default: $sb .= $c; } $cursor->advanceBy(1); } if ($sb !== '') { $cells[] = $sb; } return $cells; } } PK ! ��+j! ! Extension/Table/TableSection.phpnu ȯ�� <?php declare(strict_types=1); /* * This is part of the league/commonmark package. * * (c) Martin Hasoň <martin.hason@gmail.com> * (c) Webuni s.r.o. <info@webuni.cz> * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Table; use League\CommonMark\Node\Block\AbstractBlock; final class TableSection extends AbstractBlock { public const TYPE_HEAD = 'head'; public const TYPE_BODY = 'body'; /** * @psalm-var self::TYPE_* * @phpstan-var self::TYPE_* * * @psalm-readonly */ private string $type; /** * @psalm-param self::TYPE_* $type * * @phpstan-param self::TYPE_* $type */ public function __construct(string $type = self::TYPE_BODY) { parent::__construct(); $this->type = $type; } /** * @psalm-return self::TYPE_* * * @phpstan-return self::TYPE_* */ public function getType(): string { return $this->type; } public function isHead(): bool { return $this->type === self::TYPE_HEAD; } public function isBody(): bool { return $this->type === self::TYPE_BODY; } } PK ! �k߫� � ! Extension/Table/TableRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This is part of the league/commonmark package. * * (c) Martin Hasoň <martin.hason@gmail.com> * (c) Webuni s.r.o. <info@webuni.cz> * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Table; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class TableRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param Table $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { Table::assertInstanceOf($node); $attrs = $node->data->get('attributes'); $separator = $childRenderer->getInnerSeparator(); $children = $childRenderer->renderNodes($node->children()); return new HtmlElement('table', $attrs, $separator . \trim($children) . $separator); } public function getXmlTagName(Node $node): string { return 'table'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } } PK ! ��� � " Extension/Table/TableExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This is part of the league/commonmark package. * * (c) Martin Hasoň <martin.hason@gmail.com> * (c) Webuni s.r.o. <info@webuni.cz> * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Table; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\CommonMark\Renderer\HtmlDecorator; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; final class TableExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $attributeArraySchema = Expect::arrayOf( Expect::type('string|string[]|bool'), // attribute value(s) 'string' // attribute name )->mergeDefaults(false); $builder->addSchema('table', Expect::structure([ 'wrap' => Expect::structure([ 'enabled' => Expect::bool()->default(false), 'tag' => Expect::string()->default('div'), 'attributes' => Expect::arrayOf(Expect::string()), ]), 'alignment_attributes' => Expect::structure([ 'left' => (clone $attributeArraySchema)->default(['align' => 'left']), 'center' => (clone $attributeArraySchema)->default(['align' => 'center']), 'right' => (clone $attributeArraySchema)->default(['align' => 'right']), ]), ])); } public function register(EnvironmentBuilderInterface $environment): void { $tableRenderer = new TableRenderer(); if ($environment->getConfiguration()->get('table/wrap/enabled')) { $tableRenderer = new HtmlDecorator($tableRenderer, $environment->getConfiguration()->get('table/wrap/tag'), $environment->getConfiguration()->get('table/wrap/attributes')); } $environment ->addBlockStartParser(new TableStartParser()) ->addRenderer(Table::class, $tableRenderer) ->addRenderer(TableSection::class, new TableSectionRenderer()) ->addRenderer(TableRow::class, new TableRowRenderer()) ->addRenderer(TableCell::class, new TableCellRenderer($environment->getConfiguration()->get('table/alignment_attributes'))); } } PK ! �Y� � Extension/Table/Table.phpnu ȯ�� <?php declare(strict_types=1); /* * This is part of the league/commonmark package. * * (c) Martin Hasoň <martin.hason@gmail.com> * (c) Webuni s.r.o. <info@webuni.cz> * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Table; use League\CommonMark\Node\Block\AbstractBlock; final class Table extends AbstractBlock { } PK ! _I��� � $ Extension/Table/TableStartParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This is part of the league/commonmark package. * * (c) Martin Hasoň <martin.hason@gmail.com> * (c) Webuni s.r.o. <info@webuni.cz> * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Table; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Block\ParagraphParser; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; final class TableStartParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { $paragraph = $parserState->getParagraphContent(); if ($paragraph === null || \strpos($paragraph, '|') === false) { return BlockStart::none(); } $columns = self::parseSeparator($cursor); if (\count($columns) === 0) { return BlockStart::none(); } $lines = \explode("\n", $paragraph); $lastLine = \array_pop($lines); $headerCells = TableParser::split($lastLine); if (\count($headerCells) > \count($columns)) { return BlockStart::none(); } $cursor->advanceToEnd(); $parsers = []; if (\count($lines) > 0) { $p = new ParagraphParser(); $p->addLine(\implode("\n", $lines)); $parsers[] = $p; } $parsers[] = new TableParser($columns, $headerCells); return BlockStart::of(...$parsers) ->at($cursor) ->replaceActiveBlockParser(); } /** * @return array<int, string|null> * * @psalm-return array<int, TableCell::ALIGN_*|null> * * @phpstan-return array<int, TableCell::ALIGN_*|null> */ private static function parseSeparator(Cursor $cursor): array { $columns = []; $pipes = 0; $valid = false; while (! $cursor->isAtEnd()) { switch ($c = $cursor->getCurrentCharacter()) { case '|': $cursor->advanceBy(1); $pipes++; if ($pipes > 1) { // More than one adjacent pipe not allowed return []; } // Need at least one pipe, even for a one-column table $valid = true; break; case '-': case ':': if ($pipes === 0 && \count($columns) > 0) { // Need a pipe after the first column (first column doesn't need to start with one) return []; } $left = false; $right = false; if ($c === ':') { $left = true; $cursor->advanceBy(1); } if ($cursor->match('/^-+/') === null) { // Need at least one dash return []; } if ($cursor->getCurrentCharacter() === ':') { $right = true; $cursor->advanceBy(1); } $columns[] = self::getAlignment($left, $right); // Next, need another pipe $pipes = 0; break; case ' ': case "\t": // White space is allowed between pipes and columns $cursor->advanceToNextNonSpaceOrTab(); break; default: // Any other character is invalid return []; } } if (! $valid) { return []; } return $columns; } /** * @psalm-return TableCell::ALIGN_*|null * * @phpstan-return TableCell::ALIGN_*|null * * @psalm-pure */ private static function getAlignment(bool $left, bool $right): ?string { if ($left && $right) { return TableCell::ALIGN_CENTER; } if ($left) { return TableCell::ALIGN_LEFT; } if ($right) { return TableCell::ALIGN_RIGHT; } return null; } } PK ! �2�� � Extension/Table/TableRow.phpnu ȯ�� <?php declare(strict_types=1); /* * This is part of the league/commonmark package. * * (c) Martin Hasoň <martin.hason@gmail.com> * (c) Webuni s.r.o. <info@webuni.cz> * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Table; use League\CommonMark\Node\Block\AbstractBlock; final class TableRow extends AbstractBlock { } PK ! C�� � . Extension/Attributes/Node/AttributesInline.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) 2015 Martin Hasoň <martin.hason@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Attributes\Node; use League\CommonMark\Node\Inline\AbstractInline; final class AttributesInline extends AbstractInline { /** @var array<string, mixed> */ private array $attributes; private bool $block; /** * @param array<string, mixed> $attributes */ public function __construct(array $attributes, bool $block) { parent::__construct(); $this->attributes = $attributes; $this->block = $block; } /** * @return array<string, mixed> */ public function getAttributes(): array { return $this->attributes; } /** * @param array<string, mixed> $attributes */ public function setAttributes(array $attributes): void { $this->attributes = $attributes; } public function isBlock(): bool { return $this->block; } } PK ! >�w w ( Extension/Attributes/Node/Attributes.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) 2015 Martin Hasoň <martin.hason@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Attributes\Node; use League\CommonMark\Node\Block\AbstractBlock; final class Attributes extends AbstractBlock { public const TARGET_PARENT = 0; public const TARGET_PREVIOUS = 1; public const TARGET_NEXT = 2; /** @var array<string, mixed> */ private array $attributes; private int $target = self::TARGET_NEXT; /** * @param array<string, mixed> $attributes */ public function __construct(array $attributes) { parent::__construct(); $this->attributes = $attributes; } /** * @return array<string, mixed> */ public function getAttributes(): array { return $this->attributes; } /** * @param array<string, mixed> $attributes */ public function setAttributes(array $attributes): void { $this->attributes = $attributes; } public function getTarget(): int { return $this->target; } public function setTarget(int $target): void { $this->target = $target; } } PK ! 0�dŘ � , Extension/Attributes/AttributesExtension.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) 2015 Martin Hasoň <martin.hason@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Attributes; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\Attributes\Event\AttributesListener; use League\CommonMark\Extension\Attributes\Parser\AttributesBlockStartParser; use League\CommonMark\Extension\Attributes\Parser\AttributesInlineParser; use League\CommonMark\Extension\ExtensionInterface; final class AttributesExtension implements ExtensionInterface { public function register(EnvironmentBuilderInterface $environment): void { $environment->addBlockStartParser(new AttributesBlockStartParser()); $environment->addInlineParser(new AttributesInlineParser()); $environment->addEventListener(DocumentParsedEvent::class, [new AttributesListener(), 'processDocument']); } } PK ! Z��C C 1 Extension/Attributes/Event/AttributesListener.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) 2015 Martin Hasoň <martin.hason@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Attributes\Event; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\Attributes\Node\Attributes; use League\CommonMark\Extension\Attributes\Node\AttributesInline; use League\CommonMark\Extension\Attributes\Util\AttributesHelper; use League\CommonMark\Extension\CommonMark\Node\Block\FencedCode; use League\CommonMark\Extension\CommonMark\Node\Block\ListBlock; use League\CommonMark\Extension\CommonMark\Node\Block\ListItem; use League\CommonMark\Node\Inline\AbstractInline; use League\CommonMark\Node\Node; final class AttributesListener { private const DIRECTION_PREFIX = 'prefix'; private const DIRECTION_SUFFIX = 'suffix'; public function processDocument(DocumentParsedEvent $event): void { foreach ($event->getDocument()->iterator() as $node) { if (! ($node instanceof Attributes || $node instanceof AttributesInline)) { continue; } [$target, $direction] = self::findTargetAndDirection($node); if ($target instanceof Node) { $parent = $target->parent(); if ($parent instanceof ListItem && $parent->parent() instanceof ListBlock && $parent->parent()->isTight()) { $target = $parent; } if ($direction === self::DIRECTION_SUFFIX) { $attributes = AttributesHelper::mergeAttributes($target, $node->getAttributes()); } else { $attributes = AttributesHelper::mergeAttributes($node->getAttributes(), $target); } $target->data->set('attributes', $attributes); } $node->detach(); } } /** * @param Attributes|AttributesInline $node * * @return array<Node|string|null> */ private static function findTargetAndDirection($node): array { $target = null; $direction = null; $previous = $next = $node; while (true) { $previous = self::getPrevious($previous); $next = self::getNext($next); if ($previous === null && $next === null) { if (! $node->parent() instanceof FencedCode) { $target = $node->parent(); $direction = self::DIRECTION_SUFFIX; } break; } if ($node instanceof AttributesInline && ($previous === null || ($previous instanceof AbstractInline && $node->isBlock()))) { continue; } if ($previous !== null && ! self::isAttributesNode($previous)) { $target = $previous; $direction = self::DIRECTION_SUFFIX; break; } if ($next !== null && ! self::isAttributesNode($next)) { $target = $next; $direction = self::DIRECTION_PREFIX; break; } } return [$target, $direction]; } /** * Get any previous block (sibling or parent) this might apply to */ private static function getPrevious(?Node $node = null): ?Node { if ($node instanceof Attributes) { if ($node->getTarget() === Attributes::TARGET_NEXT) { return null; } if ($node->getTarget() === Attributes::TARGET_PARENT) { return $node->parent(); } } return $node instanceof Node ? $node->previous() : null; } /** * Get any previous block (sibling or parent) this might apply to */ private static function getNext(?Node $node = null): ?Node { if ($node instanceof Attributes && $node->getTarget() !== Attributes::TARGET_NEXT) { return null; } return $node instanceof Node ? $node->next() : null; } private static function isAttributesNode(Node $node): bool { return $node instanceof Attributes || $node instanceof AttributesInline; } } PK ! Z���K K : Extension/Attributes/Parser/AttributesBlockStartParser.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) 2015 Martin Hasoň <martin.hason@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Attributes\Parser; use League\CommonMark\Extension\Attributes\Util\AttributesHelper; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; final class AttributesBlockStartParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { $originalPosition = $cursor->getPosition(); $attributes = AttributesHelper::parseAttributes($cursor); if ($attributes === [] && $originalPosition === $cursor->getPosition()) { return BlockStart::none(); } if ($cursor->getNextNonSpaceCharacter() !== null) { return BlockStart::none(); } return BlockStart::of(new AttributesBlockContinueParser($attributes, $parserState->getActiveBlockParser()->getBlock()))->at($cursor); } } PK ! Mǯ'� � 6 Extension/Attributes/Parser/AttributesInlineParser.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) 2015 Martin Hasoň <martin.hason@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Attributes\Parser; use League\CommonMark\Extension\Attributes\Node\AttributesInline; use League\CommonMark\Extension\Attributes\Util\AttributesHelper; use League\CommonMark\Node\StringContainerInterface; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; final class AttributesInlineParser implements InlineParserInterface { public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::string('{'); } public function parse(InlineParserContext $inlineContext): bool { $cursor = $inlineContext->getCursor(); $char = (string) $cursor->peek(-1); $attributes = AttributesHelper::parseAttributes($cursor); if ($attributes === []) { return false; } if ($char === ' ' && ($prev = $inlineContext->getContainer()->lastChild()) instanceof StringContainerInterface) { $prev->setLiteral(\rtrim($prev->getLiteral(), ' ')); } if ($char === '') { $cursor->advanceToNextNonSpaceOrNewline(); } $node = new AttributesInline($attributes, $char === ' ' || $char === ''); $inlineContext->getContainer()->appendChild($node); return true; } } PK ! _;�0� � = Extension/Attributes/Parser/AttributesBlockContinueParser.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) 2015 Martin Hasoň <martin.hason@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Attributes\Parser; use League\CommonMark\Extension\Attributes\Node\Attributes; use League\CommonMark\Extension\Attributes\Util\AttributesHelper; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; final class AttributesBlockContinueParser extends AbstractBlockContinueParser { private Attributes $block; private AbstractBlock $container; private bool $hasSubsequentLine = false; /** * @param array<string, mixed> $attributes The attributes identified by the block start parser * @param AbstractBlock $container The node we were in when these attributes were discovered */ public function __construct(array $attributes, AbstractBlock $container) { $this->block = new Attributes($attributes); $this->container = $container; } public function getBlock(): AbstractBlock { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { $this->hasSubsequentLine = true; $cursor->advanceToNextNonSpaceOrTab(); // Does this next line also have attributes? $attributes = AttributesHelper::parseAttributes($cursor); $cursor->advanceToNextNonSpaceOrTab(); if ($cursor->isAtEnd() && $attributes !== []) { // It does! Merge them into what we parsed previously $this->block->setAttributes(AttributesHelper::mergeAttributes( $this->block->getAttributes(), $attributes )); // Tell the core parser we've consumed everything return BlockContinue::at($cursor); } // Okay, so there are no attributes on the next line // If this next line is blank we know we can't target the next node, it must be a previous one if ($cursor->isBlank()) { $this->block->setTarget(Attributes::TARGET_PREVIOUS); } return BlockContinue::none(); } public function closeBlock(): void { // Attributes appearing at the very end of the document won't have any last lines to check // so we can make that determination here if (! $this->hasSubsequentLine) { $this->block->setTarget(Attributes::TARGET_PREVIOUS); } // We know this block must apply to the "previous" block, but that could be a sibling or parent, // so we check the containing block to see which one it might be. if ($this->block->getTarget() === Attributes::TARGET_PREVIOUS && $this->block->parent() === $this->container) { $this->block->setTarget(Attributes::TARGET_PARENT); } } } PK ! �� G� � . Extension/Attributes/Util/AttributesHelper.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) 2015 Martin Hasoň <martin.hason@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Attributes\Util; use League\CommonMark\Node\Node; use League\CommonMark\Parser\Cursor; use League\CommonMark\Util\RegexHelper; /** * @internal */ final class AttributesHelper { private const SINGLE_ATTRIBUTE = '\s*([.]-?[_a-z][^\s}]*|[#][^\s}]+|' . RegexHelper::PARTIAL_ATTRIBUTENAME . RegexHelper::PARTIAL_ATTRIBUTEVALUESPEC . ')\s*'; private const ATTRIBUTE_LIST = '/^{:?(' . self::SINGLE_ATTRIBUTE . ')+}/i'; /** * @return array<string, mixed> */ public static function parseAttributes(Cursor $cursor): array { $state = $cursor->saveState(); $cursor->advanceToNextNonSpaceOrNewline(); // Quick check to see if we might have attributes if ($cursor->getCharacter() !== '{') { $cursor->restoreState($state); return []; } // Attempt to match the entire attribute list expression // While this is less performant than checking for '{' now and '}' later, it simplifies // matching individual attributes since they won't need to look ahead for the closing '}' // while dealing with the fact that attributes can technically contain curly braces. // So we'll just match the start and end braces up front. $attributeExpression = $cursor->match(self::ATTRIBUTE_LIST); if ($attributeExpression === null) { $cursor->restoreState($state); return []; } // Trim the leading '{' or '{:' and the trailing '}' $attributeExpression = \ltrim(\substr($attributeExpression, 1, -1), ':'); $attributeCursor = new Cursor($attributeExpression); /** @var array<string, mixed> $attributes */ $attributes = []; while ($attribute = \trim((string) $attributeCursor->match('/^' . self::SINGLE_ATTRIBUTE . '/i'))) { if ($attribute[0] === '#') { $attributes['id'] = \substr($attribute, 1); continue; } if ($attribute[0] === '.') { $attributes['class'][] = \substr($attribute, 1); continue; } /** @psalm-suppress PossiblyUndefinedArrayOffset */ [$name, $value] = \explode('=', $attribute, 2); if ($value === 'true') { $attributes[$name] = true; continue; } $first = $value[0]; $last = \substr($value, -1); if (($first === '"' && $last === '"') || ($first === "'" && $last === "'") && \strlen($value) > 1) { $value = \substr($value, 1, -1); } if (\strtolower(\trim($name)) === 'class') { foreach (\array_filter(\explode(' ', \trim($value))) as $class) { $attributes['class'][] = $class; } } else { $attributes[\trim($name)] = \trim($value); } } if (isset($attributes['class'])) { $attributes['class'] = \implode(' ', (array) $attributes['class']); } return $attributes; } /** * @param Node|array<string, mixed> $attributes1 * @param Node|array<string, mixed> $attributes2 * * @return array<string, mixed> */ public static function mergeAttributes($attributes1, $attributes2): array { $attributes = []; foreach ([$attributes1, $attributes2] as $arg) { if ($arg instanceof Node) { $arg = $arg->data->get('attributes'); } /** @var array<string, mixed> $arg */ $arg = (array) $arg; if (isset($arg['class'])) { if (\is_string($arg['class'])) { $arg['class'] = \array_filter(\explode(' ', \trim($arg['class']))); } foreach ($arg['class'] as $class) { $attributes['class'][] = $class; } unset($arg['class']); } $attributes = \array_merge($attributes, $arg); } if (isset($attributes['class'])) { $attributes['class'] = \implode(' ', $attributes['class']); } return $attributes; } } PK ! h�N� � G Extension/CommonMark/Delimiter/Processor/EmphasisDelimiterProcessor.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java) * - (c) Atlassian Pty Ltd * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Delimiter\Processor; use League\CommonMark\Delimiter\DelimiterInterface; use League\CommonMark\Delimiter\Processor\DelimiterProcessorInterface; use League\CommonMark\Extension\CommonMark\Node\Inline\Emphasis; use League\CommonMark\Extension\CommonMark\Node\Inline\Strong; use League\CommonMark\Node\Inline\AbstractStringContainer; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class EmphasisDelimiterProcessor implements DelimiterProcessorInterface, ConfigurationAwareInterface { /** @psalm-readonly */ private string $char; /** @psalm-readonly-allow-private-mutation */ private ConfigurationInterface $config; /** * @param string $char The emphasis character to use (typically '*' or '_') */ public function __construct(string $char) { $this->char = $char; } public function getOpeningCharacter(): string { return $this->char; } public function getClosingCharacter(): string { return $this->char; } public function getMinLength(): int { return 1; } public function getDelimiterUse(DelimiterInterface $opener, DelimiterInterface $closer): int { // "Multiple of 3" rule for internal delimiter runs if (($opener->canClose() || $closer->canOpen()) && $closer->getOriginalLength() % 3 !== 0 && ($opener->getOriginalLength() + $closer->getOriginalLength()) % 3 === 0) { return 0; } // Calculate actual number of delimiters used from this closer if ($opener->getLength() >= 2 && $closer->getLength() >= 2) { if ($this->config->get('commonmark/enable_strong')) { return 2; } return 0; } if ($this->config->get('commonmark/enable_em')) { return 1; } return 0; } public function process(AbstractStringContainer $opener, AbstractStringContainer $closer, int $delimiterUse): void { if ($delimiterUse === 1) { $emphasis = new Emphasis($this->char); } elseif ($delimiterUse === 2) { $emphasis = new Strong($this->char . $this->char); } else { return; } $next = $opener->next(); while ($next !== null && $next !== $closer) { $tmp = $next->next(); $emphasis->appendChild($next); $next = $tmp; } $opener->insertAfter($emphasis); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } } PK ! h�{U U 0 Extension/CommonMark/CommonMarkCoreExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Extension\CommonMark\Delimiter\Processor\EmphasisDelimiterProcessor; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\CommonMark\Node as CoreNode; use League\CommonMark\Parser as CoreParser; use League\CommonMark\Renderer as CoreRenderer; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; final class CommonMarkCoreExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $builder->addSchema('commonmark', Expect::structure([ 'use_asterisk' => Expect::bool(true), 'use_underscore' => Expect::bool(true), 'enable_strong' => Expect::bool(true), 'enable_em' => Expect::bool(true), 'unordered_list_markers' => Expect::listOf('string')->min(1)->default(['*', '+', '-'])->mergeDefaults(false), ])); } // phpcs:disable Generic.Functions.FunctionCallArgumentSpacing.TooMuchSpaceAfterComma,Squiz.WhiteSpace.SemicolonSpacing.Incorrect public function register(EnvironmentBuilderInterface $environment): void { $environment ->addBlockStartParser(new Parser\Block\BlockQuoteStartParser(), 70) ->addBlockStartParser(new Parser\Block\HeadingStartParser(), 60) ->addBlockStartParser(new Parser\Block\FencedCodeStartParser(), 50) ->addBlockStartParser(new Parser\Block\HtmlBlockStartParser(), 40) ->addBlockStartParser(new Parser\Block\ThematicBreakStartParser(), 20) ->addBlockStartParser(new Parser\Block\ListBlockStartParser(), 10) ->addBlockStartParser(new Parser\Block\IndentedCodeStartParser(), -100) ->addInlineParser(new CoreParser\Inline\NewlineParser(), 200) ->addInlineParser(new Parser\Inline\BacktickParser(), 150) ->addInlineParser(new Parser\Inline\EscapableParser(), 80) ->addInlineParser(new Parser\Inline\EntityParser(), 70) ->addInlineParser(new Parser\Inline\AutolinkParser(), 50) ->addInlineParser(new Parser\Inline\HtmlInlineParser(), 40) ->addInlineParser(new Parser\Inline\CloseBracketParser(), 30) ->addInlineParser(new Parser\Inline\OpenBracketParser(), 20) ->addInlineParser(new Parser\Inline\BangParser(), 10) ->addRenderer(Node\Block\BlockQuote::class, new Renderer\Block\BlockQuoteRenderer(), 0) ->addRenderer(CoreNode\Block\Document::class, new CoreRenderer\Block\DocumentRenderer(), 0) ->addRenderer(Node\Block\FencedCode::class, new Renderer\Block\FencedCodeRenderer(), 0) ->addRenderer(Node\Block\Heading::class, new Renderer\Block\HeadingRenderer(), 0) ->addRenderer(Node\Block\HtmlBlock::class, new Renderer\Block\HtmlBlockRenderer(), 0) ->addRenderer(Node\Block\IndentedCode::class, new Renderer\Block\IndentedCodeRenderer(), 0) ->addRenderer(Node\Block\ListBlock::class, new Renderer\Block\ListBlockRenderer(), 0) ->addRenderer(Node\Block\ListItem::class, new Renderer\Block\ListItemRenderer(), 0) ->addRenderer(CoreNode\Block\Paragraph::class, new CoreRenderer\Block\ParagraphRenderer(), 0) ->addRenderer(Node\Block\ThematicBreak::class, new Renderer\Block\ThematicBreakRenderer(), 0) ->addRenderer(Node\Inline\Code::class, new Renderer\Inline\CodeRenderer(), 0) ->addRenderer(Node\Inline\Emphasis::class, new Renderer\Inline\EmphasisRenderer(), 0) ->addRenderer(Node\Inline\HtmlInline::class, new Renderer\Inline\HtmlInlineRenderer(), 0) ->addRenderer(Node\Inline\Image::class, new Renderer\Inline\ImageRenderer(), 0) ->addRenderer(Node\Inline\Link::class, new Renderer\Inline\LinkRenderer(), 0) ->addRenderer(CoreNode\Inline\Newline::class, new CoreRenderer\Inline\NewlineRenderer(), 0) ->addRenderer(Node\Inline\Strong::class, new Renderer\Inline\StrongRenderer(), 0) ->addRenderer(CoreNode\Inline\Text::class, new CoreRenderer\Inline\TextRenderer(), 0) ; if ($environment->getConfiguration()->get('commonmark/use_asterisk')) { $environment->addDelimiterProcessor(new EmphasisDelimiterProcessor('*')); } if ($environment->getConfiguration()->get('commonmark/use_underscore')) { $environment->addDelimiterProcessor(new EmphasisDelimiterProcessor('_')); } } } PK ! ��� � + Extension/CommonMark/Node/Inline/Strong.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Inline; use League\CommonMark\Node\Inline\AbstractInline; use League\CommonMark\Node\Inline\DelimitedInterface; final class Strong extends AbstractInline implements DelimitedInterface { private string $delimiter; public function __construct(string $delimiter = '**') { parent::__construct(); $this->delimiter = $delimiter; } public function getOpeningDelimiter(): string { return $this->delimiter; } public function getClosingDelimiter(): string { return $this->delimiter; } } PK ! 0֝�T T ) Extension/CommonMark/Node/Inline/Link.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Inline; use League\CommonMark\Node\Inline\Text; class Link extends AbstractWebResource { protected ?string $title = null; public function __construct(string $url, ?string $label = null, ?string $title = null) { parent::__construct($url); if ($label !== null && $label !== '') { $this->appendChild(new Text($label)); } $this->title = $title; } public function getTitle(): ?string { if ($this->title === '') { return null; } return $this->title; } public function setTitle(?string $title): void { $this->title = $title; } } PK ! �x�� � / Extension/CommonMark/Node/Inline/HtmlInline.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Inline; use League\CommonMark\Node\Inline\AbstractStringContainer; use League\CommonMark\Node\RawMarkupContainerInterface; final class HtmlInline extends AbstractStringContainer implements RawMarkupContainerInterface { } PK ! P�2U U * Extension/CommonMark/Node/Inline/Image.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Inline; use League\CommonMark\Node\Inline\Text; class Image extends AbstractWebResource { protected ?string $title = null; public function __construct(string $url, ?string $label = null, ?string $title = null) { parent::__construct($url); if ($label !== null && $label !== '') { $this->appendChild(new Text($label)); } $this->title = $title; } public function getTitle(): ?string { if ($this->title === '') { return null; } return $this->title; } public function setTitle(?string $title): void { $this->title = $title; } } PK ! ��h�6 6 ) Extension/CommonMark/Node/Inline/Code.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Inline; use League\CommonMark\Node\Inline\AbstractStringContainer; class Code extends AbstractStringContainer { } PK ! <̋� � - Extension/CommonMark/Node/Inline/Emphasis.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Inline; use League\CommonMark\Node\Inline\AbstractInline; use League\CommonMark\Node\Inline\DelimitedInterface; final class Emphasis extends AbstractInline implements DelimitedInterface { private string $delimiter; public function __construct(string $delimiter = '_') { parent::__construct(); $this->delimiter = $delimiter; } public function getOpeningDelimiter(): string { return $this->delimiter; } public function getClosingDelimiter(): string { return $this->delimiter; } } PK ! 놘�o o 8 Extension/CommonMark/Node/Inline/AbstractWebResource.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Inline; use League\CommonMark\Node\Inline\AbstractInline; abstract class AbstractWebResource extends AbstractInline { protected string $url; public function __construct(string $url) { parent::__construct(); $this->url = $url; } public function getUrl(): string { return $this->url; } public function setUrl(string $url): void { $this->url = $url; } } PK ! �5�i@ @ , Extension/CommonMark/Node/Block/ListItem.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Block; use League\CommonMark\Node\Block\AbstractBlock; class ListItem extends AbstractBlock { /** @psalm-readonly */ protected ListData $listData; public function __construct(ListData $listData) { parent::__construct(); $this->listData = $listData; } public function getListData(): ListData { return $this->listData; } } PK ! ��_�8 8 , Extension/CommonMark/Node/Block/ListData.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Block; class ListData { public ?int $start = null; public int $padding = 0; /** * @psalm-var ListBlock::TYPE_* * @phpstan-var ListBlock::TYPE_* */ public string $type; /** * @psalm-var ListBlock::DELIM_*|null * @phpstan-var ListBlock::DELIM_*|null */ public ?string $delimiter = null; public ?string $bulletChar = null; public int $markerOffset; public function equals(ListData $data): bool { return $this->type === $data->type && $this->delimiter === $data->delimiter && $this->bulletChar === $data->bulletChar; } } PK ! t>Pb b + Extension/CommonMark/Node/Block/Heading.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Block; use League\CommonMark\Node\Block\AbstractBlock; final class Heading extends AbstractBlock { private int $level; public function __construct(int $level) { parent::__construct(); $this->level = $level; } public function getLevel(): int { return $this->level; } public function setLevel(int $level): void { $this->level = $level; } } PK ! �[�� � 0 Extension/CommonMark/Node/Block/IndentedCode.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Block; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Node\StringContainerInterface; final class IndentedCode extends AbstractBlock implements StringContainerInterface { private string $literal = ''; public function getLiteral(): string { return $this->literal; } public function setLiteral(string $literal): void { $this->literal = $literal; } } PK ! kE�8 8 - Extension/CommonMark/Node/Block/ListBlock.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Block; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Node\Block\TightBlockInterface; class ListBlock extends AbstractBlock implements TightBlockInterface { public const TYPE_BULLET = 'bullet'; public const TYPE_ORDERED = 'ordered'; public const DELIM_PERIOD = 'period'; public const DELIM_PAREN = 'paren'; protected bool $tight = false; // TODO Make lists tight by default in v3 /** @psalm-readonly */ protected ListData $listData; public function __construct(ListData $listData) { parent::__construct(); $this->listData = $listData; } public function getListData(): ListData { return $this->listData; } public function isTight(): bool { return $this->tight; } public function setTight(bool $tight): void { $this->tight = $tight; } } PK ! ��0' ' - Extension/CommonMark/Node/Block/HtmlBlock.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Block; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Node\RawMarkupContainerInterface; final class HtmlBlock extends AbstractBlock implements RawMarkupContainerInterface { // Any changes to these constants should be reflected in .phpstorm.meta.php public const TYPE_1_CODE_CONTAINER = 1; public const TYPE_2_COMMENT = 2; public const TYPE_3 = 3; public const TYPE_4 = 4; public const TYPE_5_CDATA = 5; public const TYPE_6_BLOCK_ELEMENT = 6; public const TYPE_7_MISC_ELEMENT = 7; /** * @psalm-var self::TYPE_* $type * @phpstan-var self::TYPE_* $type */ private int $type; private string $literal = ''; /** * @psalm-param self::TYPE_* $type * * @phpstan-param self::TYPE_* $type */ public function __construct(int $type) { parent::__construct(); $this->type = $type; } /** * @psalm-return self::TYPE_* * * @phpstan-return self::TYPE_* */ public function getType(): int { return $this->type; } /** * @psalm-param self::TYPE_* $type * * @phpstan-param self::TYPE_* $type */ public function setType(int $type): void { $this->type = $type; } public function getLiteral(): string { return $this->literal; } public function setLiteral(string $literal): void { $this->literal = $literal; } } PK ! �`I�� � . Extension/CommonMark/Node/Block/BlockQuote.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Block; use League\CommonMark\Node\Block\AbstractBlock; class BlockQuote extends AbstractBlock { } PK ! ��>�� � 1 Extension/CommonMark/Node/Block/ThematicBreak.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Block; use League\CommonMark\Node\Block\AbstractBlock; class ThematicBreak extends AbstractBlock { } PK ! �>l>� � . Extension/CommonMark/Node/Block/FencedCode.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Node\Block; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Node\StringContainerInterface; final class FencedCode extends AbstractBlock implements StringContainerInterface { private ?string $info = null; private string $literal = ''; private int $length; private string $char; private int $offset; public function __construct(int $length, string $char, int $offset) { parent::__construct(); $this->length = $length; $this->char = $char; $this->offset = $offset; } public function getInfo(): ?string { return $this->info; } /** * @return string[] */ public function getInfoWords(): array { return \preg_split('/\s+/', $this->info ?? '') ?: []; } public function setInfo(string $info): void { $this->info = $info; } public function getLiteral(): string { return $this->literal; } public function setLiteral(string $literal): void { $this->literal = $literal; } public function getChar(): string { return $this->char; } public function setChar(string $char): void { $this->char = $char; } public function getLength(): int { return $this->length; } public function setLength(int $length): void { $this->length = $length; } public function getOffset(): int { return $this->offset; } public function setOffset(int $offset): void { $this->offset = $offset; } } PK ! yZ' � � 7 Extension/CommonMark/Renderer/Inline/StrongRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Inline; use League\CommonMark\Extension\CommonMark\Node\Inline\Strong; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class StrongRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param Strong $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { Strong::assertInstanceOf($node); $attrs = $node->data->get('attributes'); return new HtmlElement('strong', $attrs, $childRenderer->renderNodes($node->children())); } public function getXmlTagName(Node $node): string { return 'strong'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } } PK ! � ]�� � 6 Extension/CommonMark/Renderer/Inline/ImageRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Inline; use League\CommonMark\Extension\CommonMark\Node\Inline\Image; use League\CommonMark\Node\Inline\Newline; use League\CommonMark\Node\Node; use League\CommonMark\Node\NodeIterator; use League\CommonMark\Node\StringContainerInterface; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Util\RegexHelper; use League\CommonMark\Xml\XmlNodeRendererInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class ImageRenderer implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface { /** @psalm-readonly-allow-private-mutation */ private ConfigurationInterface $config; /** * @param Image $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { Image::assertInstanceOf($node); $attrs = $node->data->get('attributes'); $forbidUnsafeLinks = ! $this->config->get('allow_unsafe_links'); if ($forbidUnsafeLinks && RegexHelper::isLinkPotentiallyUnsafe($node->getUrl())) { $attrs['src'] = ''; } else { $attrs['src'] = $node->getUrl(); } $attrs['alt'] = $this->getAltText($node); if (($title = $node->getTitle()) !== null) { $attrs['title'] = $title; } return new HtmlElement('img', $attrs, '', true); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } public function getXmlTagName(Node $node): string { return 'image'; } /** * @param Image $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { Image::assertInstanceOf($node); return [ 'destination' => $node->getUrl(), 'title' => $node->getTitle() ?? '', ]; } private function getAltText(Image $node): string { $altText = ''; foreach ((new NodeIterator($node)) as $n) { if ($n instanceof StringContainerInterface) { $altText .= $n->getLiteral(); } elseif ($n instanceof Newline) { $altText .= "\n"; } } return $altText; } } PK ! S>qL9 9 5 Extension/CommonMark/Renderer/Inline/LinkRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Inline; use League\CommonMark\Extension\CommonMark\Node\Inline\Link; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Util\RegexHelper; use League\CommonMark\Xml\XmlNodeRendererInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class LinkRenderer implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface { /** @psalm-readonly-allow-private-mutation */ private ConfigurationInterface $config; /** * @param Link $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { Link::assertInstanceOf($node); $attrs = $node->data->get('attributes'); $forbidUnsafeLinks = ! $this->config->get('allow_unsafe_links'); if (! ($forbidUnsafeLinks && RegexHelper::isLinkPotentiallyUnsafe($node->getUrl()))) { $attrs['href'] = $node->getUrl(); } if (($title = $node->getTitle()) !== null) { $attrs['title'] = $title; } if (isset($attrs['target']) && $attrs['target'] === '_blank' && ! isset($attrs['rel'])) { $attrs['rel'] = 'noopener noreferrer'; } return new HtmlElement('a', $attrs, $childRenderer->renderNodes($node->children())); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } public function getXmlTagName(Node $node): string { return 'link'; } /** * @param Link $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { Link::assertInstanceOf($node); return [ 'destination' => $node->getUrl(), 'title' => $node->getTitle() ?? '', ]; } } PK ! ?��� � 9 Extension/CommonMark/Renderer/Inline/EmphasisRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Inline; use League\CommonMark\Extension\CommonMark\Node\Inline\Emphasis; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class EmphasisRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param Emphasis $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { Emphasis::assertInstanceOf($node); $attrs = $node->data->get('attributes'); return new HtmlElement('em', $attrs, $childRenderer->renderNodes($node->children())); } public function getXmlTagName(Node $node): string { return 'emph'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } } PK ! (� � � 5 Extension/CommonMark/Renderer/Inline/CodeRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Inline; use League\CommonMark\Extension\CommonMark\Node\Inline\Code; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Util\Xml; use League\CommonMark\Xml\XmlNodeRendererInterface; final class CodeRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param Code $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { Code::assertInstanceOf($node); $attrs = $node->data->get('attributes'); return new HtmlElement('code', $attrs, Xml::escape($node->getLiteral())); } public function getXmlTagName(Node $node): string { return 'code'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } } PK ! �� �2 2 ; Extension/CommonMark/Renderer/Inline/HtmlInlineRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Inline; use League\CommonMark\Extension\CommonMark\Node\Inline\HtmlInline; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlFilter; use League\CommonMark\Xml\XmlNodeRendererInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class HtmlInlineRenderer implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface { /** @psalm-readonly-allow-private-mutation */ private ConfigurationInterface $config; /** * @param HtmlInline $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): string { HtmlInline::assertInstanceOf($node); $htmlInput = $this->config->get('html_input'); return HtmlFilter::filter($node->getLiteral(), $htmlInput); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } public function getXmlTagName(Node $node): string { return 'html_inline'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } } PK ! n3`c c < Extension/CommonMark/Renderer/Block/IndentedCodeRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Block; use League\CommonMark\Extension\CommonMark\Node\Block\IndentedCode; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Util\Xml; use League\CommonMark\Xml\XmlNodeRendererInterface; final class IndentedCodeRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param IndentedCode $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { IndentedCode::assertInstanceOf($node); $attrs = $node->data->get('attributes'); return new HtmlElement( 'pre', [], new HtmlElement('code', $attrs, Xml::escape($node->getLiteral())) ); } public function getXmlTagName(Node $node): string { return 'code_block'; } /** * @return array<string, scalar> */ public function getXmlAttributes(Node $node): array { return []; } } PK ! &�t+ + 9 Extension/CommonMark/Renderer/Block/HtmlBlockRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Block; use League\CommonMark\Extension\CommonMark\Node\Block\HtmlBlock; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlFilter; use League\CommonMark\Xml\XmlNodeRendererInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class HtmlBlockRenderer implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface { /** @psalm-readonly-allow-private-mutation */ private ConfigurationInterface $config; /** * @param HtmlBlock $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): string { HtmlBlock::assertInstanceOf($node); $htmlInput = $this->config->get('html_input'); return HtmlFilter::filter($node->getLiteral(), $htmlInput); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } public function getXmlTagName(Node $node): string { return 'html_block'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } } PK ! ����� � = Extension/CommonMark/Renderer/Block/ThematicBreakRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Block; use League\CommonMark\Extension\CommonMark\Node\Block\ThematicBreak; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class ThematicBreakRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param ThematicBreak $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { ThematicBreak::assertInstanceOf($node); $attrs = $node->data->get('attributes'); return new HtmlElement('hr', $attrs, '', true); } public function getXmlTagName(Node $node): string { return 'thematic_break'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } } PK ! >9@� � 9 Extension/CommonMark/Renderer/Block/ListBlockRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Block; use League\CommonMark\Extension\CommonMark\Node\Block\ListBlock; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class ListBlockRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param ListBlock $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { ListBlock::assertInstanceOf($node); $listData = $node->getListData(); $tag = $listData->type === ListBlock::TYPE_BULLET ? 'ul' : 'ol'; $attrs = $node->data->get('attributes'); if ($listData->start !== null && $listData->start !== 1) { $attrs['start'] = (string) $listData->start; } $innerSeparator = $childRenderer->getInnerSeparator(); return new HtmlElement($tag, $attrs, $innerSeparator . $childRenderer->renderNodes($node->children()) . $innerSeparator); } public function getXmlTagName(Node $node): string { return 'list'; } /** * @param ListBlock $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { ListBlock::assertInstanceOf($node); $data = $node->getListData(); if ($data->type === ListBlock::TYPE_BULLET) { return [ 'type' => $data->type, 'tight' => $node->isTight() ? 'true' : 'false', ]; } return [ 'type' => $data->type, 'start' => $data->start ?? 1, 'tight' => $node->isTight(), 'delimiter' => $data->delimiter ?? ListBlock::DELIM_PERIOD, ]; } } PK ! ����� � : Extension/CommonMark/Renderer/Block/FencedCodeRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Block; use League\CommonMark\Extension\CommonMark\Node\Block\FencedCode; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Util\Xml; use League\CommonMark\Xml\XmlNodeRendererInterface; final class FencedCodeRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param FencedCode $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { FencedCode::assertInstanceOf($node); $attrs = $node->data->getData('attributes'); $infoWords = $node->getInfoWords(); if (\count($infoWords) !== 0 && $infoWords[0] !== '') { $class = $infoWords[0]; if (! \str_starts_with($class, 'language-')) { $class = 'language-' . $class; } $attrs->append('class', $class); } return new HtmlElement( 'pre', [], new HtmlElement('code', $attrs->export(), Xml::escape($node->getLiteral())) ); } public function getXmlTagName(Node $node): string { return 'code_block'; } /** * @param FencedCode $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { FencedCode::assertInstanceOf($node); if (($info = $node->getInfo()) === null || $info === '') { return []; } return ['info' => $info]; } } PK ! #�t�2 2 8 Extension/CommonMark/Renderer/Block/ListItemRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Block; use League\CommonMark\Extension\CommonMark\Node\Block\ListItem; use League\CommonMark\Extension\TaskList\TaskListItemMarker; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class ListItemRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param ListItem $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { ListItem::assertInstanceOf($node); $contents = $childRenderer->renderNodes($node->children()); if (\substr($contents, 0, 1) === '<' && ! $this->startsTaskListItem($node)) { $contents = "\n" . $contents; } if (\substr($contents, -1, 1) === '>') { $contents .= "\n"; } $attrs = $node->data->get('attributes'); return new HtmlElement('li', $attrs, $contents); } public function getXmlTagName(Node $node): string { return 'item'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } private function startsTaskListItem(ListItem $block): bool { $firstChild = $block->firstChild(); return $firstChild instanceof Paragraph && $firstChild->firstChild() instanceof TaskListItemMarker; } } PK ! @ %�� � : Extension/CommonMark/Renderer/Block/BlockQuoteRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Block; use League\CommonMark\Extension\CommonMark\Node\Block\BlockQuote; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class BlockQuoteRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param BlockQuote $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { BlockQuote::assertInstanceOf($node); $attrs = $node->data->get('attributes'); $filling = $childRenderer->renderNodes($node->children()); $innerSeparator = $childRenderer->getInnerSeparator(); if ($filling === '') { return new HtmlElement('blockquote', $attrs, $innerSeparator); } return new HtmlElement( 'blockquote', $attrs, $innerSeparator . $filling . $innerSeparator ); } public function getXmlTagName(Node $node): string { return 'block_quote'; } /** * @param BlockQuote $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { return []; } } PK ! ���� � 7 Extension/CommonMark/Renderer/Block/HeadingRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Renderer\Block; use League\CommonMark\Extension\CommonMark\Node\Block\Heading; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class HeadingRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param Heading $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { Heading::assertInstanceOf($node); $tag = 'h' . $node->getLevel(); $attrs = $node->data->get('attributes'); return new HtmlElement($tag, $attrs, $childRenderer->renderNodes($node->children())); } public function getXmlTagName(Node $node): string { return 'heading'; } /** * @param Heading $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { Heading::assertInstanceOf($node); return ['level' => $node->getLevel()]; } } PK ! �5�^ ^ 5 Extension/CommonMark/Parser/Inline/BacktickParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Inline; use League\CommonMark\Extension\CommonMark\Node\Inline\Code; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; final class BacktickParser implements InlineParserInterface { public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::regex('`+'); } public function parse(InlineParserContext $inlineContext): bool { $ticks = $inlineContext->getFullMatch(); $cursor = $inlineContext->getCursor(); $cursor->advanceBy($inlineContext->getFullMatchLength()); $currentPosition = $cursor->getPosition(); $previousState = $cursor->saveState(); while ($matchingTicks = $cursor->match('/`+/m')) { if ($matchingTicks !== $ticks) { continue; } $code = $cursor->getSubstring($currentPosition, $cursor->getPosition() - $currentPosition - \strlen($ticks)); $c = \preg_replace('/\n/m', ' ', $code) ?? ''; if ( $c !== '' && $c[0] === ' ' && \substr($c, -1, 1) === ' ' && \preg_match('/[^ ]/', $c) ) { $c = \substr($c, 1, -1); } $inlineContext->getContainer()->appendChild(new Code($c)); return true; } // If we got here, we didn't match a closing backtick sequence $cursor->restoreState($previousState); $inlineContext->getContainer()->appendChild(new Text($ticks)); return true; } } PK ! �%�a a 8 Extension/CommonMark/Parser/Inline/OpenBracketParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Inline; use League\CommonMark\Delimiter\Delimiter; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; final class OpenBracketParser implements InlineParserInterface { public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::string('['); } public function parse(InlineParserContext $inlineContext): bool { $inlineContext->getCursor()->advanceBy(1); $node = new Text('[', ['delim' => true]); $inlineContext->getContainer()->appendChild($node); // Add entry to stack for this opener $delimiter = new Delimiter('[', 1, $node, true, false, $inlineContext->getCursor()->getPosition()); $inlineContext->getDelimiterStack()->push($delimiter); return true; } } PK ! ^�� � 9 Extension/CommonMark/Parser/Inline/CloseBracketParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Inline; use League\CommonMark\Environment\EnvironmentAwareInterface; use League\CommonMark\Environment\EnvironmentInterface; use League\CommonMark\Extension\CommonMark\Node\Inline\AbstractWebResource; use League\CommonMark\Extension\CommonMark\Node\Inline\Image; use League\CommonMark\Extension\CommonMark\Node\Inline\Link; use League\CommonMark\Extension\Mention\Mention; use League\CommonMark\Node\Inline\AdjacentTextMerger; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; use League\CommonMark\Reference\ReferenceInterface; use League\CommonMark\Reference\ReferenceMapInterface; use League\CommonMark\Util\LinkParserHelper; use League\CommonMark\Util\RegexHelper; final class CloseBracketParser implements InlineParserInterface, EnvironmentAwareInterface { /** @psalm-readonly-allow-private-mutation */ private EnvironmentInterface $environment; public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::string(']'); } public function parse(InlineParserContext $inlineContext): bool { // Look through stack of delimiters for a [ or ! $opener = $inlineContext->getDelimiterStack()->searchByCharacter(['[', '!']); if ($opener === null) { return false; } if (! $opener->isActive()) { // no matched opener; remove from emphasis stack $inlineContext->getDelimiterStack()->removeDelimiter($opener); return false; } $cursor = $inlineContext->getCursor(); $startPos = $cursor->getPosition(); $previousState = $cursor->saveState(); $cursor->advanceBy(1); // Check to see if we have a link/image // Inline link? if ($result = $this->tryParseInlineLinkAndTitle($cursor)) { $link = $result; } elseif ($link = $this->tryParseReference($cursor, $inlineContext->getReferenceMap(), $opener->getIndex(), $startPos)) { $reference = $link; $link = ['url' => $link->getDestination(), 'title' => $link->getTitle()]; } else { // No match $inlineContext->getDelimiterStack()->removeDelimiter($opener); // Remove this opener from stack $cursor->restoreState($previousState); return false; } $isImage = $opener->getChar() === '!'; $inline = $this->createInline($link['url'], $link['title'], $isImage, $reference ?? null); $opener->getInlineNode()->replaceWith($inline); while (($label = $inline->next()) !== null) { // Is there a Mention or Link contained within this link? // CommonMark does not allow nested links, so we'll restore the original text. if ($label instanceof Mention) { $label->replaceWith($replacement = new Text($label->getPrefix() . $label->getIdentifier())); $inline->appendChild($replacement); } elseif ($label instanceof Link) { foreach ($label->children() as $child) { $label->insertBefore($child); } $label->detach(); } else { $inline->appendChild($label); } } // Process delimiters such as emphasis inside link/image $delimiterStack = $inlineContext->getDelimiterStack(); $stackBottom = $opener->getPrevious(); $delimiterStack->processDelimiters($stackBottom, $this->environment->getDelimiterProcessors()); $delimiterStack->removeAll($stackBottom); // Merge any adjacent Text nodes together AdjacentTextMerger::mergeChildNodes($inline); // processEmphasis will remove this and later delimiters. // Now, for a link, we also remove earlier link openers (no links in links) if (! $isImage) { $inlineContext->getDelimiterStack()->removeEarlierMatches('['); } return true; } public function setEnvironment(EnvironmentInterface $environment): void { $this->environment = $environment; } /** * @return array<string, string>|null */ private function tryParseInlineLinkAndTitle(Cursor $cursor): ?array { if ($cursor->getCurrentCharacter() !== '(') { return null; } $previousState = $cursor->saveState(); $cursor->advanceBy(1); $cursor->advanceToNextNonSpaceOrNewline(); if (($dest = LinkParserHelper::parseLinkDestination($cursor)) === null) { $cursor->restoreState($previousState); return null; } $cursor->advanceToNextNonSpaceOrNewline(); $previousCharacter = $cursor->peek(-1); // We know from previous lines that we've advanced at least one space so far, so this next call should never be null \assert(\is_string($previousCharacter)); $title = ''; // make sure there's a space before the title: if (\preg_match(RegexHelper::REGEX_WHITESPACE_CHAR, $previousCharacter)) { $title = LinkParserHelper::parseLinkTitle($cursor) ?? ''; } $cursor->advanceToNextNonSpaceOrNewline(); if ($cursor->getCurrentCharacter() !== ')') { $cursor->restoreState($previousState); return null; } $cursor->advanceBy(1); return ['url' => $dest, 'title' => $title]; } private function tryParseReference(Cursor $cursor, ReferenceMapInterface $referenceMap, ?int $openerIndex, int $startPos): ?ReferenceInterface { if ($openerIndex === null) { return null; } $savePos = $cursor->saveState(); $beforeLabel = $cursor->getPosition(); $n = LinkParserHelper::parseLinkLabel($cursor); if ($n === 0 || $n === 2) { $start = $openerIndex; $length = $startPos - $openerIndex; } else { $start = $beforeLabel + 1; $length = $n - 2; } $referenceLabel = $cursor->getSubstring($start, $length); if ($n === 0) { // If shortcut reference link, rewind before spaces we skipped $cursor->restoreState($savePos); } return $referenceMap->get($referenceLabel); } private function createInline(string $url, string $title, bool $isImage, ?ReferenceInterface $reference = null): AbstractWebResource { if ($isImage) { $inline = new Image($url, null, $title); } else { $inline = new Link($url, null, $title); } if ($reference) { $inline->data->set('reference', $reference); } return $inline; } } PK ! ,���k k 6 Extension/CommonMark/Parser/Inline/EscapableParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Inline; use League\CommonMark\Node\Inline\Newline; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; use League\CommonMark\Util\RegexHelper; final class EscapableParser implements InlineParserInterface { public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::string('\\'); } public function parse(InlineParserContext $inlineContext): bool { $cursor = $inlineContext->getCursor(); $nextChar = $cursor->peek(); if ($nextChar === "\n") { $cursor->advanceBy(2); $inlineContext->getContainer()->appendChild(new Newline(Newline::HARDBREAK)); return true; } if ($nextChar !== null && RegexHelper::isEscapable($nextChar)) { $cursor->advanceBy(2); $inlineContext->getContainer()->appendChild(new Text($nextChar)); return true; } $cursor->advanceBy(1); $inlineContext->getContainer()->appendChild(new Text('\\')); return true; } } PK ! {���� � 7 Extension/CommonMark/Parser/Inline/HtmlInlineParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Inline; use League\CommonMark\Extension\CommonMark\Node\Inline\HtmlInline; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; use League\CommonMark\Util\RegexHelper; final class HtmlInlineParser implements InlineParserInterface { public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::regex(RegexHelper::PARTIAL_HTMLTAG)->caseSensitive(); } public function parse(InlineParserContext $inlineContext): bool { $inline = $inlineContext->getFullMatch(); $inlineContext->getCursor()->advanceBy($inlineContext->getFullMatchLength()); $inlineContext->getContainer()->appendChild(new HtmlInline($inline)); return true; } } PK ! ��L�b b 5 Extension/CommonMark/Parser/Inline/AutolinkParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Inline; use League\CommonMark\Extension\CommonMark\Node\Inline\Link; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; use League\CommonMark\Util\UrlEncoder; final class AutolinkParser implements InlineParserInterface { private const EMAIL_REGEX = '<([a-zA-Z0-9.!#$%&\'*+\\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*)>'; private const OTHER_LINK_REGEX = '<([A-Za-z][A-Za-z0-9.+-]{1,31}:[^<>\x00-\x20]*)>'; public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::regex(self::EMAIL_REGEX . '|' . self::OTHER_LINK_REGEX); } public function parse(InlineParserContext $inlineContext): bool { $inlineContext->getCursor()->advanceBy($inlineContext->getFullMatchLength()); $matches = $inlineContext->getMatches(); if ($matches[1] !== '') { $inlineContext->getContainer()->appendChild(new Link('mailto:' . UrlEncoder::unescapeAndEncode($matches[1]), $matches[1])); return true; } if ($matches[2] !== '') { $inlineContext->getContainer()->appendChild(new Link(UrlEncoder::unescapeAndEncode($matches[2]), $matches[2])); return true; } return false; // This should never happen } } PK ! Ɗ>d d 1 Extension/CommonMark/Parser/Inline/BangParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Inline; use League\CommonMark\Delimiter\Delimiter; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; final class BangParser implements InlineParserInterface { public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::string('!['); } public function parse(InlineParserContext $inlineContext): bool { $cursor = $inlineContext->getCursor(); $cursor->advanceBy(2); $node = new Text('![', ['delim' => true]); $inlineContext->getContainer()->appendChild($node); // Add entry to stack for this opener $delimiter = new Delimiter('!', 1, $node, true, false, $cursor->getPosition()); $inlineContext->getDelimiterStack()->push($delimiter); return true; } } PK ! �9�E 3 Extension/CommonMark/Parser/Inline/EntityParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Inline; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; use League\CommonMark\Util\Html5EntityDecoder; use League\CommonMark\Util\RegexHelper; final class EntityParser implements InlineParserInterface { public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::regex(RegexHelper::PARTIAL_ENTITY); } public function parse(InlineParserContext $inlineContext): bool { $entity = $inlineContext->getFullMatch(); $inlineContext->getCursor()->advanceBy($inlineContext->getFullMatchLength()); $inlineContext->getContainer()->appendChild(new Text(Html5EntityDecoder::decode($entity))); return true; } } PK ! ��]� � 6 Extension/CommonMark/Parser/Block/FencedCodeParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Extension\CommonMark\Node\Block\FencedCode; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Util\ArrayCollection; use League\CommonMark\Util\RegexHelper; final class FencedCodeParser extends AbstractBlockContinueParser { /** @psalm-readonly */ private FencedCode $block; /** @var ArrayCollection<string> */ private ArrayCollection $strings; public function __construct(int $fenceLength, string $fenceChar, int $fenceOffset) { $this->block = new FencedCode($fenceLength, $fenceChar, $fenceOffset); $this->strings = new ArrayCollection(); } public function getBlock(): FencedCode { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { // Check for closing code fence if (! $cursor->isIndented() && $cursor->getNextNonSpaceCharacter() === $this->block->getChar()) { $match = RegexHelper::matchFirst('/^(?:`{3,}|~{3,})(?=[ \t]*$)/', $cursor->getLine(), $cursor->getNextNonSpacePosition()); if ($match !== null && \strlen($match[0]) >= $this->block->getLength()) { // closing fence - we're at end of line, so we can finalize now return BlockContinue::finished(); } } // Skip optional spaces of fence offset // Optimization: don't attempt to match if we're at a non-space position if ($cursor->getNextNonSpacePosition() > $cursor->getPosition()) { $cursor->match('/^ {0,' . $this->block->getOffset() . '}/'); } return BlockContinue::at($cursor); } public function addLine(string $line): void { $this->strings[] = $line; } public function closeBlock(): void { // first line becomes info string $firstLine = $this->strings->first(); if ($firstLine === false) { $firstLine = ''; } $this->block->setInfo(RegexHelper::unescape(\trim($firstLine))); if ($this->strings->count() === 1) { $this->block->setLiteral(''); } else { $this->block->setLiteral(\implode("\n", $this->strings->slice(1)) . "\n"); } } } PK ! �}� V V : Extension/CommonMark/Parser/Block/HtmlBlockStartParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Extension\CommonMark\Node\Block\HtmlBlock; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; use League\CommonMark\Util\RegexHelper; final class HtmlBlockStartParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { if ($cursor->isIndented() || $cursor->getNextNonSpaceCharacter() !== '<') { return BlockStart::none(); } $tmpCursor = clone $cursor; $tmpCursor->advanceToNextNonSpaceOrTab(); $line = $tmpCursor->getRemainder(); for ($blockType = 1; $blockType <= 7; $blockType++) { /** @psalm-var HtmlBlock::TYPE_* $blockType */ /** @phpstan-var HtmlBlock::TYPE_* $blockType */ $match = RegexHelper::matchAt( RegexHelper::getHtmlBlockOpenRegex($blockType), $line ); if ($match !== null && ($blockType < 7 || $this->isType7BlockAllowed($cursor, $parserState))) { return BlockStart::of(new HtmlBlockParser($blockType))->at($cursor); } } return BlockStart::none(); } private function isType7BlockAllowed(Cursor $cursor, MarkdownParserStateInterface $parserState): bool { // Type 7 blocks can't interrupt paragraphs if ($parserState->getLastMatchedBlockParser()->getBlock() instanceof Paragraph) { return false; } // Even lazy ones return ! $parserState->getActiveBlockParser()->canHaveLazyContinuationLines(); } } PK ! Kz��* * 6 Extension/CommonMark/Parser/Block/BlockQuoteParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Extension\CommonMark\Node\Block\BlockQuote; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; final class BlockQuoteParser extends AbstractBlockContinueParser { /** @psalm-readonly */ private BlockQuote $block; public function __construct() { $this->block = new BlockQuote(); } public function getBlock(): BlockQuote { return $this->block; } public function isContainer(): bool { return true; } public function canContain(AbstractBlock $childBlock): bool { return true; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { if (! $cursor->isIndented() && $cursor->getNextNonSpaceCharacter() === '>') { $cursor->advanceToNextNonSpaceOrTab(); $cursor->advanceBy(1); $cursor->advanceBySpaceOrTab(); return BlockContinue::at($cursor); } return BlockContinue::none(); } } PK ! *P�� � 8 Extension/CommonMark/Parser/Block/HeadingStartParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; use League\CommonMark\Util\RegexHelper; class HeadingStartParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { if ($cursor->isIndented() || ! \in_array($cursor->getNextNonSpaceCharacter(), ['#', '-', '='], true)) { return BlockStart::none(); } $cursor->advanceToNextNonSpaceOrTab(); if ($atxHeading = self::getAtxHeader($cursor)) { return BlockStart::of($atxHeading)->at($cursor); } $setextHeadingLevel = self::getSetextHeadingLevel($cursor); if ($setextHeadingLevel > 0) { $content = $parserState->getParagraphContent(); if ($content !== null) { $cursor->advanceToEnd(); return BlockStart::of(new HeadingParser($setextHeadingLevel, $content)) ->at($cursor) ->replaceActiveBlockParser(); } } return BlockStart::none(); } private static function getAtxHeader(Cursor $cursor): ?HeadingParser { $match = RegexHelper::matchFirst('/^#{1,6}(?:[ \t]+|$)/', $cursor->getRemainder()); if (! $match) { return null; } $cursor->advanceToNextNonSpaceOrTab(); $cursor->advanceBy(\strlen($match[0])); $level = \strlen(\trim($match[0])); $str = $cursor->getRemainder(); $str = \preg_replace('/^[ \t]*#+[ \t]*$/', '', $str); \assert(\is_string($str)); $str = \preg_replace('/[ \t]+#+[ \t]*$/', '', $str); \assert(\is_string($str)); return new HeadingParser($level, $str); } private static function getSetextHeadingLevel(Cursor $cursor): int { $match = RegexHelper::matchFirst('/^(?:=+|-+)[ \t]*$/', $cursor->getRemainder()); if ($match === null) { return 0; } return $match[0][0] === '=' ? 1 : 2; } } PK ! ���W� � > Extension/CommonMark/Parser/Block/ThematicBreakStartParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; use League\CommonMark\Util\RegexHelper; final class ThematicBreakStartParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { if ($cursor->isIndented()) { return BlockStart::none(); } $match = RegexHelper::matchAt(RegexHelper::REGEX_THEMATIC_BREAK, $cursor->getLine(), $cursor->getNextNonSpacePosition()); if ($match === null) { return BlockStart::none(); } // Advance to the end of the string, consuming the entire line (of the thematic break) $cursor->advanceToEnd(); return BlockStart::of(new ThematicBreakParser())->at($cursor); } } PK ! �$��e e 8 Extension/CommonMark/Parser/Block/IndentedCodeParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Extension\CommonMark\Node\Block\IndentedCode; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Util\ArrayCollection; final class IndentedCodeParser extends AbstractBlockContinueParser { /** @psalm-readonly */ private IndentedCode $block; /** @var ArrayCollection<string> */ private ArrayCollection $strings; public function __construct() { $this->block = new IndentedCode(); $this->strings = new ArrayCollection(); } public function getBlock(): IndentedCode { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { if ($cursor->isIndented()) { $cursor->advanceBy(Cursor::INDENT_LEVEL, true); return BlockContinue::at($cursor); } if ($cursor->isBlank()) { $cursor->advanceToNextNonSpaceOrTab(); return BlockContinue::at($cursor); } return BlockContinue::none(); } public function addLine(string $line): void { $this->strings[] = $line; } public function closeBlock(): void { $lines = $this->strings->toArray(); // Note that indented code block cannot be empty, so $lines will always have at least one non-empty element while (\preg_match('/^[ \t]*$/', \end($lines))) { // @phpstan-ignore-line \array_pop($lines); } $this->block->setLiteral(\implode("\n", $lines) . "\n"); $this->block->setEndLine($this->block->getStartLine() + \count($lines) - 1); } } PK ! �Xѷ� � ; Extension/CommonMark/Parser/Block/FencedCodeStartParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; final class FencedCodeStartParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { if ($cursor->isIndented() || ! \in_array($cursor->getNextNonSpaceCharacter(), ['`', '~'], true)) { return BlockStart::none(); } $indent = $cursor->getIndent(); $fence = $cursor->match('/^[ \t]*(?:`{3,}(?!.*`)|~{3,})/'); if ($fence === null) { return BlockStart::none(); } // fenced code block $fence = \ltrim($fence, " \t"); return BlockStart::of(new FencedCodeParser(\strlen($fence), $fence[0], $indent))->at($cursor); } } PK ! �nL�� � 3 Extension/CommonMark/Parser/Block/HeadingParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Extension\CommonMark\Node\Block\Heading; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Block\BlockContinueParserWithInlinesInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\InlineParserEngineInterface; final class HeadingParser extends AbstractBlockContinueParser implements BlockContinueParserWithInlinesInterface { /** @psalm-readonly */ private Heading $block; private string $content; public function __construct(int $level, string $content) { $this->block = new Heading($level); $this->content = $content; } public function getBlock(): Heading { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { return BlockContinue::none(); } public function parseInlines(InlineParserEngineInterface $inlineParser): void { $inlineParser->parse($this->content, $this->block); } } PK ! {�j� � 5 Extension/CommonMark/Parser/Block/HtmlBlockParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Extension\CommonMark\Node\Block\HtmlBlock; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Util\RegexHelper; final class HtmlBlockParser extends AbstractBlockContinueParser { /** @psalm-readonly */ private HtmlBlock $block; private string $content = ''; private bool $finished = false; /** * @psalm-param HtmlBlock::TYPE_* $blockType * * @phpstan-param HtmlBlock::TYPE_* $blockType */ public function __construct(int $blockType) { $this->block = new HtmlBlock($blockType); } public function getBlock(): HtmlBlock { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { if ($this->finished) { return BlockContinue::none(); } if ($cursor->isBlank() && \in_array($this->block->getType(), [HtmlBlock::TYPE_6_BLOCK_ELEMENT, HtmlBlock::TYPE_7_MISC_ELEMENT], true)) { return BlockContinue::none(); } return BlockContinue::at($cursor); } public function addLine(string $line): void { if ($this->content !== '') { $this->content .= "\n"; } $this->content .= $line; // Check for end condition // phpcs:disable SlevomatCodingStandard.ControlStructures.EarlyExit.EarlyExitNotUsed if ($this->block->getType() <= HtmlBlock::TYPE_5_CDATA) { if (\preg_match(RegexHelper::getHtmlBlockCloseRegex($this->block->getType()), $line) === 1) { $this->finished = true; } } } public function closeBlock(): void { $this->block->setLiteral($this->content); $this->content = ''; } } PK ! C�e� � = Extension/CommonMark/Parser/Block/IndentedCodeStartParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; final class IndentedCodeStartParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { if (! $cursor->isIndented()) { return BlockStart::none(); } if ($parserState->getActiveBlockParser()->getBlock() instanceof Paragraph) { return BlockStart::none(); } if ($cursor->isBlank()) { return BlockStart::none(); } $cursor->advanceBy(Cursor::INDENT_LEVEL, true); return BlockStart::of(new IndentedCodeParser())->at($cursor); } } PK ! ���� � 5 Extension/CommonMark/Parser/Block/ListBlockParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Extension\CommonMark\Node\Block\ListBlock; use League\CommonMark\Extension\CommonMark\Node\Block\ListData; use League\CommonMark\Extension\CommonMark\Node\Block\ListItem; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; final class ListBlockParser extends AbstractBlockContinueParser { /** @psalm-readonly */ private ListBlock $block; public function __construct(ListData $listData) { $this->block = new ListBlock($listData); } public function getBlock(): ListBlock { return $this->block; } public function isContainer(): bool { return true; } public function canContain(AbstractBlock $childBlock): bool { return $childBlock instanceof ListItem; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { // List blocks themselves don't have any markers, only list items. So try to stay in the list. // If there is a block start other than list item, canContain makes sure that this list is closed. return BlockContinue::at($cursor); } public function closeBlock(): void { $item = $this->block->firstChild(); while ($item instanceof AbstractBlock) { // check for non-final list item ending with blank line: if ($item->next() !== null && self::endsWithBlankLine($item)) { $this->block->setTight(false); break; } // recurse into children of list item, to see if there are spaces between any of them $subitem = $item->firstChild(); while ($subitem instanceof AbstractBlock) { if ($subitem->next() && self::endsWithBlankLine($subitem)) { $this->block->setTight(false); break 2; } $subitem = $subitem->next(); } $item = $item->next(); } $lastChild = $this->block->lastChild(); if ($lastChild instanceof AbstractBlock) { $this->block->setEndLine($lastChild->getEndLine()); } } private static function endsWithBlankLine(AbstractBlock $block): bool { $next = $block->next(); return $next instanceof AbstractBlock && $block->getEndLine() !== $next->getStartLine() - 1; } } PK ! �O< t t 4 Extension/CommonMark/Parser/Block/ListItemParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Extension\CommonMark\Node\Block\ListData; use League\CommonMark\Extension\CommonMark\Node\Block\ListItem; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; final class ListItemParser extends AbstractBlockContinueParser { /** @psalm-readonly */ private ListItem $block; public function __construct(ListData $listData) { $this->block = new ListItem($listData); } public function getBlock(): ListItem { return $this->block; } public function isContainer(): bool { return true; } public function canContain(AbstractBlock $childBlock): bool { return ! $childBlock instanceof ListItem; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { if ($cursor->isBlank()) { if ($this->block->firstChild() === null) { // Blank line after empty list item return BlockContinue::none(); } $cursor->advanceToNextNonSpaceOrTab(); return BlockContinue::at($cursor); } $contentIndent = $this->block->getListData()->markerOffset + $this->getBlock()->getListData()->padding; if ($cursor->getIndent() >= $contentIndent) { $cursor->advanceBy($contentIndent, true); return BlockContinue::at($cursor); } // Note: We'll hit this case for lazy continuation lines, they will get added later. return BlockContinue::none(); } public function closeBlock(): void { if (($lastChild = $this->block->lastChild()) instanceof AbstractBlock) { $this->block->setEndLine($lastChild->getEndLine()); } else { // Empty list item $this->block->setEndLine($this->block->getStartLine()); } } } PK ! k�0� � : Extension/CommonMark/Parser/Block/ListBlockStartParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Extension\CommonMark\Node\Block\ListBlock; use League\CommonMark\Extension\CommonMark\Node\Block\ListData; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; use League\CommonMark\Util\RegexHelper; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class ListBlockStartParser implements BlockStartParserInterface, ConfigurationAwareInterface { /** @psalm-readonly-allow-private-mutation */ private ?ConfigurationInterface $config = null; /** * @psalm-var non-empty-string|null * * @psalm-readonly-allow-private-mutation */ private ?string $listMarkerRegex = null; public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { if ($cursor->isIndented()) { return BlockStart::none(); } $listData = $this->parseList($cursor, $parserState->getParagraphContent() !== null); if ($listData === null) { return BlockStart::none(); } $listItemParser = new ListItemParser($listData); // prepend the list block if needed $matched = $parserState->getLastMatchedBlockParser(); if (! ($matched instanceof ListBlockParser) || ! $listData->equals($matched->getBlock()->getListData())) { $listBlockParser = new ListBlockParser($listData); // We start out with assuming a list is tight. If we find a blank line, we set it to loose later. // TODO for 3.0: Just make them tight by default in the block so we can remove this call $listBlockParser->getBlock()->setTight(true); return BlockStart::of($listBlockParser, $listItemParser)->at($cursor); } return BlockStart::of($listItemParser)->at($cursor); } private function parseList(Cursor $cursor, bool $inParagraph): ?ListData { $indent = $cursor->getIndent(); $tmpCursor = clone $cursor; $tmpCursor->advanceToNextNonSpaceOrTab(); $rest = $tmpCursor->getRemainder(); if (\preg_match($this->listMarkerRegex ?? $this->generateListMarkerRegex(), $rest) === 1) { $data = new ListData(); $data->markerOffset = $indent; $data->type = ListBlock::TYPE_BULLET; $data->delimiter = null; $data->bulletChar = $rest[0]; $markerLength = 1; } elseif (($matches = RegexHelper::matchFirst('/^(\d{1,9})([.)])/', $rest)) && (! $inParagraph || $matches[1] === '1')) { $data = new ListData(); $data->markerOffset = $indent; $data->type = ListBlock::TYPE_ORDERED; $data->start = (int) $matches[1]; $data->delimiter = $matches[2] === '.' ? ListBlock::DELIM_PERIOD : ListBlock::DELIM_PAREN; $data->bulletChar = null; $markerLength = \strlen($matches[0]); } else { return null; } // Make sure we have spaces after $nextChar = $tmpCursor->peek($markerLength); if (! ($nextChar === null || $nextChar === "\t" || $nextChar === ' ')) { return null; } // If it interrupts paragraph, make sure first line isn't blank if ($inParagraph && ! RegexHelper::matchAt(RegexHelper::REGEX_NON_SPACE, $rest, $markerLength)) { return null; } $cursor->advanceToNextNonSpaceOrTab(); // to start of marker $cursor->advanceBy($markerLength, true); // to end of marker $data->padding = self::calculateListMarkerPadding($cursor, $markerLength); return $data; } private static function calculateListMarkerPadding(Cursor $cursor, int $markerLength): int { $start = $cursor->saveState(); $spacesStartCol = $cursor->getColumn(); while ($cursor->getColumn() - $spacesStartCol < 5) { if (! $cursor->advanceBySpaceOrTab()) { break; } } $blankItem = $cursor->peek() === null; $spacesAfterMarker = $cursor->getColumn() - $spacesStartCol; if ($spacesAfterMarker >= 5 || $spacesAfterMarker < 1 || $blankItem) { $cursor->restoreState($start); $cursor->advanceBySpaceOrTab(); return $markerLength + 1; } return $markerLength + $spacesAfterMarker; } /** * @psalm-return non-empty-string */ private function generateListMarkerRegex(): string { // No configuration given - use the defaults if ($this->config === null) { return $this->listMarkerRegex = '/^[*+-]/'; } $markers = $this->config->get('commonmark/unordered_list_markers'); \assert(\is_array($markers)); return $this->listMarkerRegex = '/^[' . \preg_quote(\implode('', $markers), '/') . ']/'; } } PK ! ���Y Y ; Extension/CommonMark/Parser/Block/BlockQuoteStartParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; final class BlockQuoteStartParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { if ($cursor->isIndented()) { return BlockStart::none(); } if ($cursor->getNextNonSpaceCharacter() !== '>') { return BlockStart::none(); } $cursor->advanceToNextNonSpaceOrTab(); $cursor->advanceBy(1); $cursor->advanceBySpaceOrTab(); return BlockStart::of(new BlockQuoteParser())->at($cursor); } } PK ! ��ᄖ � 9 Extension/CommonMark/Parser/Block/ThematicBreakParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\CommonMark\Parser\Block; use League\CommonMark\Extension\CommonMark\Node\Block\ThematicBreak; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; final class ThematicBreakParser extends AbstractBlockContinueParser { /** @psalm-readonly */ private ThematicBreak $block; public function __construct() { $this->block = new ThematicBreak(); } public function getBlock(): ThematicBreak { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { // a horizontal rule can never container > 1 line, so fail to match return BlockContinue::none(); } } PK ! ��{z z 6 Extension/TableOfContents/TableOfContentsExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\CommonMark\Node\Block\ListBlock; use League\CommonMark\Extension\CommonMark\Renderer\Block\ListBlockRenderer; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\CommonMark\Extension\TableOfContents\Node\TableOfContents; use League\CommonMark\Extension\TableOfContents\Node\TableOfContentsPlaceholder; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; final class TableOfContentsExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $builder->addSchema('table_of_contents', Expect::structure([ 'position' => Expect::anyOf(TableOfContentsBuilder::POSITION_BEFORE_HEADINGS, TableOfContentsBuilder::POSITION_PLACEHOLDER, TableOfContentsBuilder::POSITION_TOP)->default(TableOfContentsBuilder::POSITION_TOP), 'style' => Expect::anyOf(ListBlock::TYPE_BULLET, ListBlock::TYPE_ORDERED)->default(ListBlock::TYPE_BULLET), 'normalize' => Expect::anyOf(TableOfContentsGenerator::NORMALIZE_RELATIVE, TableOfContentsGenerator::NORMALIZE_FLAT, TableOfContentsGenerator::NORMALIZE_DISABLED)->default(TableOfContentsGenerator::NORMALIZE_RELATIVE), 'min_heading_level' => Expect::int()->min(1)->max(6)->default(1), 'max_heading_level' => Expect::int()->min(1)->max(6)->default(6), 'html_class' => Expect::string()->default('table-of-contents'), 'placeholder' => Expect::anyOf(Expect::string(), Expect::null())->default(null), ])); } public function register(EnvironmentBuilderInterface $environment): void { $environment->addRenderer(TableOfContents::class, new TableOfContentsRenderer(new ListBlockRenderer())); $environment->addEventListener(DocumentParsedEvent::class, [new TableOfContentsBuilder(), 'onDocumentParsed'], -150); // phpcs:ignore SlevomatCodingStandard.ControlStructures.EarlyExit.EarlyExitNotUsed if ($environment->getConfiguration()->get('table_of_contents/position') === TableOfContentsBuilder::POSITION_PLACEHOLDER) { $environment->addBlockStartParser(TableOfContentsPlaceholderParser::blockStartParser(), 200); // If a placeholder cannot be replaced with a TOC element this renderer will ensure the parser won't error out $environment->addRenderer(TableOfContentsPlaceholder::class, new TableOfContentsPlaceholderRenderer()); } } } PK ! �;ۿ @ Extension/TableOfContents/TableOfContentsPlaceholderRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Xml\XmlNodeRendererInterface; final class TableOfContentsPlaceholderRenderer implements NodeRendererInterface, XmlNodeRendererInterface { public function render(Node $node, ChildNodeRendererInterface $childRenderer): string { return '<!-- table of contents -->'; } public function getXmlTagName(Node $node): string { return 'table_of_contents_placeholder'; } /** * @return array<string, scalar> */ public function getXmlAttributes(Node $node): array { return []; } } PK ! ��[� � > Extension/TableOfContents/TableOfContentsPlaceholderParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents; use League\CommonMark\Extension\TableOfContents\Node\TableOfContentsPlaceholder; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class TableOfContentsPlaceholderParser extends AbstractBlockContinueParser { /** @psalm-readonly */ private TableOfContentsPlaceholder $block; public function __construct() { $this->block = new TableOfContentsPlaceholder(); } public function getBlock(): TableOfContentsPlaceholder { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { return BlockContinue::none(); } public static function blockStartParser(): BlockStartParserInterface { return new class () implements BlockStartParserInterface, ConfigurationAwareInterface { /** @psalm-readonly-allow-private-mutation */ private ConfigurationInterface $config; public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { $placeholder = $this->config->get('table_of_contents/placeholder'); if ($placeholder === null) { return BlockStart::none(); } // The placeholder must be the only thing on the line if ($cursor->match('/^' . \preg_quote($placeholder, '/') . '$/') === null) { return BlockStart::none(); } return BlockStart::of(new TableOfContentsPlaceholderParser())->at($cursor); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } }; } } PK ! �_��� � 2 Extension/TableOfContents/Node/TableOfContents.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents\Node; use League\CommonMark\Extension\CommonMark\Node\Block\ListBlock; final class TableOfContents extends ListBlock { } PK ! è�� � = Extension/TableOfContents/Node/TableOfContentsPlaceholder.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents\Node; use League\CommonMark\Node\Block\AbstractBlock; final class TableOfContentsPlaceholder extends AbstractBlock { } PK ! SH� D Extension/TableOfContents/Normalizer/NormalizerStrategyInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents\Normalizer; use League\CommonMark\Extension\CommonMark\Node\Block\ListItem; interface NormalizerStrategyInterface { public function addItem(int $level, ListItem $listItemToAdd): void; } PK ! U�Ti� � C Extension/TableOfContents/Normalizer/RelativeNormalizerStrategy.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents\Normalizer; use League\CommonMark\Extension\CommonMark\Node\Block\ListBlock; use League\CommonMark\Extension\CommonMark\Node\Block\ListItem; use League\CommonMark\Extension\TableOfContents\Node\TableOfContents; final class RelativeNormalizerStrategy implements NormalizerStrategyInterface { /** @psalm-readonly */ private TableOfContents $toc; /** * @var array<int, ListItem> * * @psalm-readonly-allow-private-mutation */ private array $listItemStack = []; public function __construct(TableOfContents $toc) { $this->toc = $toc; } public function addItem(int $level, ListItem $listItemToAdd): void { $previousLevel = \array_key_last($this->listItemStack); // Pop the stack if we're too deep while ($previousLevel !== null && $level < $previousLevel) { \array_pop($this->listItemStack); $previousLevel = \array_key_last($this->listItemStack); } $lastListItem = \end($this->listItemStack); // Need to go one level deeper? Add that level if ($lastListItem !== false && $level > $previousLevel) { $targetListBlock = new ListBlock($lastListItem->getListData()); $targetListBlock->setStartLine($listItemToAdd->getStartLine()); $targetListBlock->setEndLine($listItemToAdd->getEndLine()); $lastListItem->appendChild($targetListBlock); // Otherwise we're at the right level // If there's no stack we're adding this item directly to the TOC element } elseif ($lastListItem === false) { $targetListBlock = $this->toc; // Otherwise add it to the last list item } else { $targetListBlock = $lastListItem->parent(); } $targetListBlock->appendChild($listItemToAdd); $this->listItemStack[$level] = $listItemToAdd; } } PK ! @H H ? Extension/TableOfContents/Normalizer/FlatNormalizerStrategy.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents\Normalizer; use League\CommonMark\Extension\CommonMark\Node\Block\ListItem; use League\CommonMark\Extension\TableOfContents\Node\TableOfContents; final class FlatNormalizerStrategy implements NormalizerStrategyInterface { /** @psalm-readonly */ private TableOfContents $toc; public function __construct(TableOfContents $toc) { $this->toc = $toc; } public function addItem(int $level, ListItem $listItemToAdd): void { $this->toc->appendChild($listItemToAdd); } } PK ! I���e e ? Extension/TableOfContents/Normalizer/AsIsNormalizerStrategy.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents\Normalizer; use League\CommonMark\Extension\CommonMark\Node\Block\ListBlock; use League\CommonMark\Extension\CommonMark\Node\Block\ListItem; use League\CommonMark\Extension\TableOfContents\Node\TableOfContents; final class AsIsNormalizerStrategy implements NormalizerStrategyInterface { /** @psalm-readonly-allow-private-mutation */ private ListBlock $parentListBlock; /** @psalm-readonly-allow-private-mutation */ private int $parentLevel = 1; /** @psalm-readonly-allow-private-mutation */ private ?ListItem $lastListItem = null; public function __construct(TableOfContents $toc) { $this->parentListBlock = $toc; } public function addItem(int $level, ListItem $listItemToAdd): void { while ($level > $this->parentLevel) { // Descend downwards, creating new ListBlocks if needed, until we reach the correct depth if ($this->lastListItem === null) { $this->lastListItem = new ListItem($this->parentListBlock->getListData()); $this->parentListBlock->appendChild($this->lastListItem); } $newListBlock = new ListBlock($this->parentListBlock->getListData()); $newListBlock->setStartLine($listItemToAdd->getStartLine()); $newListBlock->setEndLine($listItemToAdd->getEndLine()); $this->lastListItem->appendChild($newListBlock); $this->parentListBlock = $newListBlock; $this->lastListItem = null; $this->parentLevel++; } while ($level < $this->parentLevel) { // Search upwards for the previous parent list block $search = $this->parentListBlock; while ($search = $search->parent()) { if ($search instanceof ListBlock) { $this->parentListBlock = $search; break; } } $this->parentLevel--; } $this->parentListBlock->appendChild($listItemToAdd); $this->lastListItem = $listItemToAdd; } } PK ! �8�)� � 6 Extension/TableOfContents/TableOfContentsGenerator.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents; use League\CommonMark\Extension\CommonMark\Node\Block\Heading; use League\CommonMark\Extension\CommonMark\Node\Block\ListBlock; use League\CommonMark\Extension\CommonMark\Node\Block\ListData; use League\CommonMark\Extension\CommonMark\Node\Block\ListItem; use League\CommonMark\Extension\CommonMark\Node\Inline\Link; use League\CommonMark\Extension\HeadingPermalink\HeadingPermalink; use League\CommonMark\Extension\TableOfContents\Node\TableOfContents; use League\CommonMark\Extension\TableOfContents\Normalizer\AsIsNormalizerStrategy; use League\CommonMark\Extension\TableOfContents\Normalizer\FlatNormalizerStrategy; use League\CommonMark\Extension\TableOfContents\Normalizer\NormalizerStrategyInterface; use League\CommonMark\Extension\TableOfContents\Normalizer\RelativeNormalizerStrategy; use League\CommonMark\Node\Block\Document; use League\CommonMark\Node\NodeIterator; use League\CommonMark\Node\RawMarkupContainerInterface; use League\CommonMark\Node\StringContainerHelper; use League\Config\Exception\InvalidConfigurationException; final class TableOfContentsGenerator implements TableOfContentsGeneratorInterface { public const STYLE_BULLET = ListBlock::TYPE_BULLET; public const STYLE_ORDERED = ListBlock::TYPE_ORDERED; public const NORMALIZE_DISABLED = 'as-is'; public const NORMALIZE_RELATIVE = 'relative'; public const NORMALIZE_FLAT = 'flat'; /** @psalm-readonly */ private string $style; /** @psalm-readonly */ private string $normalizationStrategy; /** @psalm-readonly */ private int $minHeadingLevel; /** @psalm-readonly */ private int $maxHeadingLevel; /** @psalm-readonly */ private string $fragmentPrefix; public function __construct(string $style, string $normalizationStrategy, int $minHeadingLevel, int $maxHeadingLevel, string $fragmentPrefix) { $this->style = $style; $this->normalizationStrategy = $normalizationStrategy; $this->minHeadingLevel = $minHeadingLevel; $this->maxHeadingLevel = $maxHeadingLevel; $this->fragmentPrefix = $fragmentPrefix; if ($fragmentPrefix !== '') { $this->fragmentPrefix .= '-'; } } public function generate(Document $document): ?TableOfContents { $toc = $this->createToc($document); $normalizer = $this->getNormalizer($toc); $firstHeading = null; foreach ($this->getHeadingLinks($document) as $headingLink) { $heading = $headingLink->parent(); // Make sure this is actually tied to a heading if (! $heading instanceof Heading) { continue; } // Skip any headings outside the configured min/max levels if ($heading->getLevel() < $this->minHeadingLevel || $heading->getLevel() > $this->maxHeadingLevel) { continue; } // Keep track of the first heading we see - we might need this later $firstHeading ??= $heading; // Keep track of the start and end lines $toc->setStartLine($firstHeading->getStartLine()); $toc->setEndLine($heading->getEndLine()); // Create the new link $link = new Link('#' . $this->fragmentPrefix . $headingLink->getSlug(), StringContainerHelper::getChildText($heading, [RawMarkupContainerInterface::class])); $listItem = new ListItem($toc->getListData()); $listItem->setStartLine($heading->getStartLine()); $listItem->setEndLine($heading->getEndLine()); $listItem->appendChild($link); // Add it to the correct place $normalizer->addItem($heading->getLevel(), $listItem); } // Don't add the TOC if no headings were present if (! $toc->hasChildren() || $firstHeading === null) { return null; } return $toc; } private function createToc(Document $document): TableOfContents { $listData = new ListData(); if ($this->style === self::STYLE_BULLET) { $listData->type = ListBlock::TYPE_BULLET; } elseif ($this->style === self::STYLE_ORDERED) { $listData->type = ListBlock::TYPE_ORDERED; } else { throw new InvalidConfigurationException(\sprintf('Invalid table of contents list style: "%s"', $this->style)); } $toc = new TableOfContents($listData); $toc->setStartLine($document->getStartLine()); $toc->setEndLine($document->getEndLine()); return $toc; } /** * @return iterable<HeadingPermalink> */ private function getHeadingLinks(Document $document): iterable { foreach ($document->iterator(NodeIterator::FLAG_BLOCKS_ONLY) as $node) { if (! $node instanceof Heading) { continue; } foreach ($node->children() as $child) { if ($child instanceof HeadingPermalink) { yield $child; } } } } private function getNormalizer(TableOfContents $toc): NormalizerStrategyInterface { switch ($this->normalizationStrategy) { case self::NORMALIZE_DISABLED: return new AsIsNormalizerStrategy($toc); case self::NORMALIZE_RELATIVE: return new RelativeNormalizerStrategy($toc); case self::NORMALIZE_FLAT: return new FlatNormalizerStrategy($toc); default: throw new InvalidConfigurationException(\sprintf('Invalid table of contents normalization strategy: "%s"', $this->normalizationStrategy)); } } } PK ! 5��a� � 4 Extension/TableOfContents/TableOfContentsBuilder.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\CommonMark\Node\Block\Heading; use League\CommonMark\Extension\HeadingPermalink\HeadingPermalink; use League\CommonMark\Extension\TableOfContents\Node\TableOfContents; use League\CommonMark\Extension\TableOfContents\Node\TableOfContentsPlaceholder; use League\CommonMark\Node\Block\Document; use League\CommonMark\Node\NodeIterator; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; use League\Config\Exception\InvalidConfigurationException; final class TableOfContentsBuilder implements ConfigurationAwareInterface { public const POSITION_TOP = 'top'; public const POSITION_BEFORE_HEADINGS = 'before-headings'; public const POSITION_PLACEHOLDER = 'placeholder'; /** @psalm-readonly-allow-private-mutation */ private ConfigurationInterface $config; public function onDocumentParsed(DocumentParsedEvent $event): void { $document = $event->getDocument(); $generator = new TableOfContentsGenerator( (string) $this->config->get('table_of_contents/style'), (string) $this->config->get('table_of_contents/normalize'), (int) $this->config->get('table_of_contents/min_heading_level'), (int) $this->config->get('table_of_contents/max_heading_level'), (string) $this->config->get('heading_permalink/fragment_prefix'), ); $toc = $generator->generate($document); if ($toc === null) { // No linkable headers exist, so no TOC could be generated return; } // Add custom CSS class(es), if defined $class = $this->config->get('table_of_contents/html_class'); if ($class !== null) { $toc->data->append('attributes/class', $class); } // Add the TOC to the Document $position = $this->config->get('table_of_contents/position'); if ($position === self::POSITION_TOP) { $document->prependChild($toc); } elseif ($position === self::POSITION_BEFORE_HEADINGS) { $this->insertBeforeFirstLinkedHeading($document, $toc); } elseif ($position === self::POSITION_PLACEHOLDER) { $this->replacePlaceholders($document, $toc); } else { throw InvalidConfigurationException::forConfigOption('table_of_contents/position', $position); } } private function insertBeforeFirstLinkedHeading(Document $document, TableOfContents $toc): void { foreach ($document->iterator(NodeIterator::FLAG_BLOCKS_ONLY) as $node) { if (! $node instanceof Heading) { continue; } foreach ($node->children() as $child) { if ($child instanceof HeadingPermalink) { $node->insertBefore($toc); return; } } } } private function replacePlaceholders(Document $document, TableOfContents $toc): void { foreach ($document->iterator(NodeIterator::FLAG_BLOCKS_ONLY) as $node) { // Add the block once we find a placeholder if (! $node instanceof TableOfContentsPlaceholder) { continue; } $node->replaceWith(clone $toc); } } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } } PK ! �DM. . ? Extension/TableOfContents/TableOfContentsGeneratorInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents; use League\CommonMark\Extension\TableOfContents\Node\TableOfContents; use League\CommonMark\Node\Block\Document; interface TableOfContentsGeneratorInterface { public function generate(Document $document): ?TableOfContents; } PK ! v��h� � 5 Extension/TableOfContents/TableOfContentsRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TableOfContents; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Xml\XmlNodeRendererInterface; final class TableOfContentsRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** @var NodeRendererInterface&XmlNodeRendererInterface */ private $innerRenderer; /** * @psalm-param NodeRendererInterface&XmlNodeRendererInterface $innerRenderer * * @phpstan-param NodeRendererInterface&XmlNodeRendererInterface $innerRenderer */ public function __construct(NodeRendererInterface $innerRenderer) { $this->innerRenderer = $innerRenderer; } /** * {@inheritDoc} */ public function render(Node $node, ChildNodeRendererInterface $childRenderer) { return $this->innerRenderer->render($node, $childRenderer); } public function getXmlTagName(Node $node): string { return 'table_of_contents'; } /** * @return array<string, scalar> */ public function getXmlAttributes(Node $node): array { return $this->innerRenderer->getXmlAttributes($node); } } PK ! �GO O ? Extension/DefaultAttributes/ApplyDefaultAttributesProcessor.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DefaultAttributes; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\Attributes\Util\AttributesHelper; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class ApplyDefaultAttributesProcessor implements ConfigurationAwareInterface { private ConfigurationInterface $config; public function onDocumentParsed(DocumentParsedEvent $event): void { /** @var array<string, array<string, mixed>> $map */ $map = $this->config->get('default_attributes'); // Don't bother iterating if no default attributes are configured if (! $map) { return; } foreach ($event->getDocument()->iterator() as $node) { // Check to see if any default attributes were defined if (($attributesToApply = $map[\get_class($node)] ?? []) === []) { continue; } $newAttributes = []; foreach ($attributesToApply as $name => $value) { if (\is_callable($value)) { $value = $value($node); // Callables are allowed to return `null` indicating that no changes should be made if ($value !== null) { $newAttributes[$name] = $value; } } else { $newAttributes[$name] = $value; } } // Merge these attributes into the node if (\count($newAttributes) > 0) { $node->data->set('attributes', AttributesHelper::mergeAttributes($node, $newAttributes)); } } } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } } PK ! ��oa� � : Extension/DefaultAttributes/DefaultAttributesExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DefaultAttributes; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; final class DefaultAttributesExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $builder->addSchema('default_attributes', Expect::arrayOf( Expect::arrayOf( Expect::type('string|string[]|bool|callable'), // attribute value(s) 'string' // attribute name ), 'string' // node FQCN )->default([])); } public function register(EnvironmentBuilderInterface $environment): void { $environment->addEventListener(DocumentParsedEvent::class, [new ApplyDefaultAttributesProcessor(), 'onDocumentParsed']); } } PK ! x��� � 2 Extension/DescriptionList/Node/DescriptionList.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DescriptionList\Node; use League\CommonMark\Node\Block\AbstractBlock; class DescriptionList extends AbstractBlock { } PK ! ��l � � 2 Extension/DescriptionList/Node/DescriptionTerm.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DescriptionList\Node; use League\CommonMark\Node\Block\AbstractBlock; class DescriptionTerm extends AbstractBlock { } PK ! _>X�C C . Extension/DescriptionList/Node/Description.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DescriptionList\Node; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Node\Block\TightBlockInterface; class Description extends AbstractBlock implements TightBlockInterface { private bool $tight; public function __construct(bool $tight = false) { parent::__construct(); $this->tight = $tight; } public function isTight(): bool { return $this->tight; } public function setTight(bool $tight): void { $this->tight = $tight; } } PK ! #�_�� � ; Extension/DescriptionList/Event/LooseDescriptionHandler.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DescriptionList\Event; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\DescriptionList\Node\Description; use League\CommonMark\Extension\DescriptionList\Node\DescriptionList; use League\CommonMark\Extension\DescriptionList\Node\DescriptionTerm; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Node\Inline\Newline; use League\CommonMark\Node\NodeIterator; final class LooseDescriptionHandler { public function __invoke(DocumentParsedEvent $event): void { foreach ($event->getDocument()->iterator(NodeIterator::FLAG_BLOCKS_ONLY) as $description) { if (! $description instanceof Description) { continue; } // Does this description need to be added to a list? if (! $description->parent() instanceof DescriptionList) { $list = new DescriptionList(); // Taking any preceding paragraphs with it if (($paragraph = $description->previous()) instanceof Paragraph) { $list->appendChild($paragraph); } $description->replaceWith($list); $list->appendChild($description); } // Is this description preceded by a paragraph that should really be a term? if (! (($paragraph = $description->previous()) instanceof Paragraph)) { continue; } // Convert the paragraph into one or more terms $term = new DescriptionTerm(); $paragraph->replaceWith($term); foreach ($paragraph->children() as $child) { if ($child instanceof Newline) { $newTerm = new DescriptionTerm(); $term->insertAfter($newTerm); $term = $newTerm; continue; } $term->appendChild($child); } } } } PK ! �d�C� � D Extension/DescriptionList/Event/ConsecutiveDescriptionListMerger.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DescriptionList\Event; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\DescriptionList\Node\DescriptionList; use League\CommonMark\Node\NodeIterator; final class ConsecutiveDescriptionListMerger { public function __invoke(DocumentParsedEvent $event): void { foreach ($event->getDocument()->iterator(NodeIterator::FLAG_BLOCKS_ONLY) as $node) { if (! $node instanceof DescriptionList) { continue; } if (! ($prev = $node->previous()) instanceof DescriptionList) { continue; } // There's another description list behind this one; merge the current one into that foreach ($node->children() as $child) { $prev->appendChild($child); } $node->detach(); } } } PK ! ��V�" " > Extension/DescriptionList/Renderer/DescriptionTermRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DescriptionList\Renderer; use League\CommonMark\Extension\DescriptionList\Node\DescriptionTerm; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; final class DescriptionTermRenderer implements NodeRendererInterface { /** * @param DescriptionTerm $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { DescriptionTerm::assertInstanceOf($node); return new HtmlElement('dt', [], $childRenderer->renderNodes($node->children())); } } PK ! Zp�w w > Extension/DescriptionList/Renderer/DescriptionListRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DescriptionList\Renderer; use League\CommonMark\Extension\DescriptionList\Node\DescriptionList; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; final class DescriptionListRenderer implements NodeRendererInterface { /** * @param DescriptionList $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): HtmlElement { DescriptionList::assertInstanceOf($node); $separator = $childRenderer->getBlockSeparator(); return new HtmlElement('dl', [], $separator . $childRenderer->renderNodes($node->children()) . $separator); } } PK ! ��H! : Extension/DescriptionList/Renderer/DescriptionRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DescriptionList\Renderer; use League\CommonMark\Extension\DescriptionList\Node\Description; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; final class DescriptionRenderer implements NodeRendererInterface { /** * @param Description $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { Description::assertInstanceOf($node); return new HtmlElement('dd', [], $childRenderer->renderNodes($node->children())); } } PK ! ���x� � B Extension/DescriptionList/Parser/DescriptionListContinueParser.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\DescriptionList\Parser; use League\CommonMark\Extension\DescriptionList\Node\Description; use League\CommonMark\Extension\DescriptionList\Node\DescriptionList; use League\CommonMark\Extension\DescriptionList\Node\DescriptionTerm; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; final class DescriptionListContinueParser extends AbstractBlockContinueParser { private DescriptionList $block; public function __construct() { $this->block = new DescriptionList(); } public function getBlock(): DescriptionList { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { return BlockContinue::at($cursor); } public function isContainer(): bool { return true; } public function canContain(AbstractBlock $childBlock): bool { return $childBlock instanceof DescriptionTerm || $childBlock instanceof Description; } } PK ! `H� � ; Extension/DescriptionList/Parser/DescriptionStartParser.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\DescriptionList\Parser; use League\CommonMark\Extension\DescriptionList\Node\Description; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; final class DescriptionStartParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { if ($cursor->isIndented()) { return BlockStart::none(); } $cursor->advanceToNextNonSpaceOrTab(); if ($cursor->match('/^:[ \t]+/') === null) { return BlockStart::none(); } $terms = $parserState->getParagraphContent(); $activeBlock = $parserState->getActiveBlockParser()->getBlock(); if ($terms !== null && $terms !== '') { // New description; tight; term(s) sitting in pending block that we will replace return BlockStart::of(...[new DescriptionListContinueParser()], ...self::splitTerms($terms), ...[new DescriptionContinueParser(true, $cursor->getPosition())]) ->at($cursor) ->replaceActiveBlockParser(); } if ($activeBlock instanceof Paragraph && $activeBlock->parent() instanceof Description) { // Additional description in the same list as the parent description return BlockStart::of(new DescriptionContinueParser(true, $cursor->getPosition()))->at($cursor); } if ($activeBlock->lastChild() instanceof Paragraph) { // New description; loose; term(s) sitting in previous closed paragraph block return BlockStart::of(new DescriptionContinueParser(false, $cursor->getPosition()))->at($cursor); } // No preceding terms return BlockStart::none(); } /** * @return array<int, DescriptionTermContinueParser> */ private static function splitTerms(string $terms): array { $ret = []; foreach (\explode("\n", $terms) as $term) { $ret[] = new DescriptionTermContinueParser($term); } return $ret; } } PK ! 9۞� B Extension/DescriptionList/Parser/DescriptionTermContinueParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DescriptionList\Parser; use League\CommonMark\Extension\DescriptionList\Node\DescriptionTerm; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Block\BlockContinueParserWithInlinesInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\InlineParserEngineInterface; final class DescriptionTermContinueParser extends AbstractBlockContinueParser implements BlockContinueParserWithInlinesInterface { private DescriptionTerm $block; private string $term; public function __construct(string $term) { $this->block = new DescriptionTerm(); $this->term = $term; } public function getBlock(): DescriptionTerm { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { return BlockContinue::finished(); } public function parseInlines(InlineParserEngineInterface $inlineParser): void { if ($this->term !== '') { $inlineParser->parse($this->term, $this->block); } } } PK ! �K��\ \ > Extension/DescriptionList/Parser/DescriptionContinueParser.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\DescriptionList\Parser; use League\CommonMark\Extension\DescriptionList\Node\Description; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; final class DescriptionContinueParser extends AbstractBlockContinueParser { private Description $block; private int $indentation; public function __construct(bool $tight, int $indentation) { $this->block = new Description($tight); $this->indentation = $indentation; } public function getBlock(): Description { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { if ($cursor->isBlank()) { if ($this->block->firstChild() === null) { // Blank line after empty item return BlockContinue::none(); } $cursor->advanceToNextNonSpaceOrTab(); return BlockContinue::at($cursor); } if ($cursor->getIndent() >= $this->indentation) { $cursor->advanceBy($this->indentation, true); return BlockContinue::at($cursor); } return BlockContinue::none(); } public function isContainer(): bool { return true; } public function canContain(AbstractBlock $childBlock): bool { return true; } } PK ! c�0�o o 6 Extension/DescriptionList/DescriptionListExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\DescriptionList; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\DescriptionList\Event\ConsecutiveDescriptionListMerger; use League\CommonMark\Extension\DescriptionList\Event\LooseDescriptionHandler; use League\CommonMark\Extension\DescriptionList\Node\Description; use League\CommonMark\Extension\DescriptionList\Node\DescriptionList; use League\CommonMark\Extension\DescriptionList\Node\DescriptionTerm; use League\CommonMark\Extension\DescriptionList\Parser\DescriptionStartParser; use League\CommonMark\Extension\DescriptionList\Renderer\DescriptionListRenderer; use League\CommonMark\Extension\DescriptionList\Renderer\DescriptionRenderer; use League\CommonMark\Extension\DescriptionList\Renderer\DescriptionTermRenderer; use League\CommonMark\Extension\ExtensionInterface; final class DescriptionListExtension implements ExtensionInterface { public function register(EnvironmentBuilderInterface $environment): void { $environment->addBlockStartParser(new DescriptionStartParser()); $environment->addEventListener(DocumentParsedEvent::class, new LooseDescriptionHandler(), 1001); $environment->addEventListener(DocumentParsedEvent::class, new ConsecutiveDescriptionListMerger(), 1000); $environment->addRenderer(DescriptionList::class, new DescriptionListRenderer()); $environment->addRenderer(DescriptionTerm::class, new DescriptionTermRenderer()); $environment->addRenderer(Description::class, new DescriptionRenderer()); } } PK ! �q�3� � 0 Extension/ExternalLink/ExternalLinkProcessor.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\ExternalLink; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\CommonMark\Node\Inline\Link; use League\Config\ConfigurationInterface; final class ExternalLinkProcessor { public const APPLY_NONE = ''; public const APPLY_ALL = 'all'; public const APPLY_EXTERNAL = 'external'; public const APPLY_INTERNAL = 'internal'; /** @psalm-readonly */ private ConfigurationInterface $config; public function __construct(ConfigurationInterface $config) { $this->config = $config; } public function __invoke(DocumentParsedEvent $e): void { $internalHosts = $this->config->get('external_link/internal_hosts'); $openInNewWindow = $this->config->get('external_link/open_in_new_window'); $classes = $this->config->get('external_link/html_class'); foreach ($e->getDocument()->iterator() as $link) { if (! ($link instanceof Link)) { continue; } $host = \parse_url($link->getUrl(), PHP_URL_HOST); if (! \is_string($host)) { // Something is terribly wrong with this URL continue; } if (self::hostMatches($host, $internalHosts)) { $link->data->set('external', false); $this->applyRelAttribute($link, false); continue; } // Host does not match our list $this->markLinkAsExternal($link, $openInNewWindow, $classes); } } private function markLinkAsExternal(Link $link, bool $openInNewWindow, string $classes): void { $link->data->set('external', true); $this->applyRelAttribute($link, true); if ($openInNewWindow) { $link->data->set('attributes/target', '_blank'); } if ($classes !== '') { $link->data->append('attributes/class', $classes); } } private function applyRelAttribute(Link $link, bool $isExternal): void { $options = [ 'nofollow' => $this->config->get('external_link/nofollow'), 'noopener' => $this->config->get('external_link/noopener'), 'noreferrer' => $this->config->get('external_link/noreferrer'), ]; foreach ($options as $type => $option) { switch (true) { case $option === self::APPLY_ALL: case $isExternal && $option === self::APPLY_EXTERNAL: case ! $isExternal && $option === self::APPLY_INTERNAL: $link->data->append('attributes/rel', $type); } } // No rel attributes? Mark the attribute as 'false' so LinkRenderer doesn't add defaults if (! $link->data->has('attributes/rel')) { $link->data->set('attributes/rel', false); } } /** * @internal This method is only public so we can easily test it. DO NOT USE THIS OUTSIDE OF THIS EXTENSION! * * @param non-empty-string|list<non-empty-string> $compareTo */ public static function hostMatches(string $host, $compareTo): bool { foreach ((array) $compareTo as $c) { if (\strpos($c, '/') === 0) { if (\preg_match($c, $host)) { return true; } } elseif ($c === $host) { return true; } } return false; } } PK ! 3W�� � 0 Extension/ExternalLink/ExternalLinkExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\ExternalLink; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; final class ExternalLinkExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $applyOptions = [ ExternalLinkProcessor::APPLY_NONE, ExternalLinkProcessor::APPLY_ALL, ExternalLinkProcessor::APPLY_INTERNAL, ExternalLinkProcessor::APPLY_EXTERNAL, ]; $builder->addSchema('external_link', Expect::structure([ 'internal_hosts' => Expect::type('string|string[]'), 'open_in_new_window' => Expect::bool(false), 'html_class' => Expect::string()->default(''), 'nofollow' => Expect::anyOf(...$applyOptions)->default(ExternalLinkProcessor::APPLY_NONE), 'noopener' => Expect::anyOf(...$applyOptions)->default(ExternalLinkProcessor::APPLY_EXTERNAL), 'noreferrer' => Expect::anyOf(...$applyOptions)->default(ExternalLinkProcessor::APPLY_EXTERNAL), ])); } public function register(EnvironmentBuilderInterface $environment): void { $environment->addEventListener(DocumentParsedEvent::class, new ExternalLinkProcessor($environment->getConfiguration()), -50); } } PK ! ���� � ( Extension/Footnote/FootnoteExtension.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\CommonMark\Extension\Footnote\Event\AnonymousFootnotesListener; use League\CommonMark\Extension\Footnote\Event\FixOrphanedFootnotesAndRefsListener; use League\CommonMark\Extension\Footnote\Event\GatherFootnotesListener; use League\CommonMark\Extension\Footnote\Event\NumberFootnotesListener; use League\CommonMark\Extension\Footnote\Node\Footnote; use League\CommonMark\Extension\Footnote\Node\FootnoteBackref; use League\CommonMark\Extension\Footnote\Node\FootnoteContainer; use League\CommonMark\Extension\Footnote\Node\FootnoteRef; use League\CommonMark\Extension\Footnote\Parser\AnonymousFootnoteRefParser; use League\CommonMark\Extension\Footnote\Parser\FootnoteRefParser; use League\CommonMark\Extension\Footnote\Parser\FootnoteStartParser; use League\CommonMark\Extension\Footnote\Renderer\FootnoteBackrefRenderer; use League\CommonMark\Extension\Footnote\Renderer\FootnoteContainerRenderer; use League\CommonMark\Extension\Footnote\Renderer\FootnoteRefRenderer; use League\CommonMark\Extension\Footnote\Renderer\FootnoteRenderer; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; final class FootnoteExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $builder->addSchema('footnote', Expect::structure([ 'backref_class' => Expect::string('footnote-backref'), 'backref_symbol' => Expect::string('↩'), 'container_add_hr' => Expect::bool(true), 'container_class' => Expect::string('footnotes'), 'ref_class' => Expect::string('footnote-ref'), 'ref_id_prefix' => Expect::string('fnref:'), 'footnote_class' => Expect::string('footnote'), 'footnote_id_prefix' => Expect::string('fn:'), ])); } public function register(EnvironmentBuilderInterface $environment): void { $environment->addBlockStartParser(new FootnoteStartParser(), 51); $environment->addInlineParser(new AnonymousFootnoteRefParser(), 35); $environment->addInlineParser(new FootnoteRefParser(), 51); $environment->addRenderer(FootnoteContainer::class, new FootnoteContainerRenderer()); $environment->addRenderer(Footnote::class, new FootnoteRenderer()); $environment->addRenderer(FootnoteRef::class, new FootnoteRefRenderer()); $environment->addRenderer(FootnoteBackref::class, new FootnoteBackrefRenderer()); $environment->addEventListener(DocumentParsedEvent::class, [new AnonymousFootnotesListener(), 'onDocumentParsed'], 40); $environment->addEventListener(DocumentParsedEvent::class, [new FixOrphanedFootnotesAndRefsListener(), 'onDocumentParsed'], 30); $environment->addEventListener(DocumentParsedEvent::class, [new NumberFootnotesListener(), 'onDocumentParsed'], 20); $environment->addEventListener(DocumentParsedEvent::class, [new GatherFootnotesListener(), 'onDocumentParsed'], 10); } } PK ! B�� � $ Extension/Footnote/Node/Footnote.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Node; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Reference\ReferenceInterface; use League\CommonMark\Reference\ReferenceableInterface; final class Footnote extends AbstractBlock implements ReferenceableInterface { /** @psalm-readonly */ private ReferenceInterface $reference; public function __construct(ReferenceInterface $reference) { parent::__construct(); $this->reference = $reference; } public function getReference(): ReferenceInterface { return $this->reference; } } PK ! ���X� � - Extension/Footnote/Node/FootnoteContainer.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Node; use League\CommonMark\Node\Block\AbstractBlock; final class FootnoteContainer extends AbstractBlock { } PK ! u.1f� � + Extension/Footnote/Node/FootnoteBackref.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Node; use League\CommonMark\Node\Inline\AbstractInline; use League\CommonMark\Reference\ReferenceInterface; use League\CommonMark\Reference\ReferenceableInterface; /** * Link from the footnote on the bottom of the document back to the reference */ final class FootnoteBackref extends AbstractInline implements ReferenceableInterface { /** @psalm-readonly */ private ReferenceInterface $reference; public function __construct(ReferenceInterface $reference) { parent::__construct(); $this->reference = $reference; } public function getReference(): ReferenceInterface { return $this->reference; } } PK ! ��wg g ' Extension/Footnote/Node/FootnoteRef.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Node; use League\CommonMark\Node\Inline\AbstractInline; use League\CommonMark\Reference\ReferenceInterface; use League\CommonMark\Reference\ReferenceableInterface; final class FootnoteRef extends AbstractInline implements ReferenceableInterface { private ReferenceInterface $reference; /** @psalm-readonly */ private ?string $content = null; /** * @param array<mixed> $data */ public function __construct(ReferenceInterface $reference, ?string $content = null, array $data = []) { parent::__construct(); $this->reference = $reference; $this->content = $content; if (\count($data) > 0) { $this->data->import($data); } } public function getReference(): ReferenceInterface { return $this->reference; } public function setReference(ReferenceInterface $reference): void { $this->reference = $reference; } public function getContent(): ?string { return $this->content; } } PK ! pܵ 1 1 @ Extension/Footnote/Event/FixOrphanedFootnotesAndRefsListener.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Event; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\Footnote\Node\Footnote; use League\CommonMark\Extension\Footnote\Node\FootnoteRef; use League\CommonMark\Node\Block\Document; use League\CommonMark\Node\Inline\Text; final class FixOrphanedFootnotesAndRefsListener { public function onDocumentParsed(DocumentParsedEvent $event): void { $document = $event->getDocument(); $map = $this->buildMapOfKnownFootnotesAndRefs($document); foreach ($map['_flat'] as $node) { if ($node instanceof FootnoteRef && ! isset($map[Footnote::class][$node->getReference()->getLabel()])) { // Found an orphaned FootnoteRef without a corresponding Footnote // Restore the original footnote ref text $node->replaceWith(new Text(\sprintf('[^%s]', $node->getReference()->getLabel()))); } // phpcs:disable SlevomatCodingStandard.ControlStructures.EarlyExit.EarlyExitNotUsed if ($node instanceof Footnote && ! isset($map[FootnoteRef::class][$node->getReference()->getLabel()])) { // Found an orphaned Footnote without a corresponding FootnoteRef // Remove the footnote $node->detach(); } } } /** @phpstan-ignore-next-line */ private function buildMapOfKnownFootnotesAndRefs(Document $document): array // @phpcs:ignore { $map = [ Footnote::class => [], FootnoteRef::class => [], '_flat' => [], ]; foreach ($document->iterator() as $node) { if ($node instanceof Footnote) { $map[Footnote::class][$node->getReference()->getLabel()] = true; $map['_flat'][] = $node; } elseif ($node instanceof FootnoteRef) { $map[FootnoteRef::class][$node->getReference()->getLabel()] = true; $map['_flat'][] = $node; } } return $map; } } PK ! �>r�� � 4 Extension/Footnote/Event/GatherFootnotesListener.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Event; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\Footnote\Node\Footnote; use League\CommonMark\Extension\Footnote\Node\FootnoteBackref; use League\CommonMark\Extension\Footnote\Node\FootnoteContainer; use League\CommonMark\Node\Block\Document; use League\CommonMark\Node\NodeIterator; use League\CommonMark\Reference\Reference; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class GatherFootnotesListener implements ConfigurationAwareInterface { private ConfigurationInterface $config; public function onDocumentParsed(DocumentParsedEvent $event): void { $document = $event->getDocument(); $footnotes = []; foreach ($document->iterator(NodeIterator::FLAG_BLOCKS_ONLY) as $node) { if (! $node instanceof Footnote) { continue; } // Look for existing reference with footnote label $ref = $document->getReferenceMap()->get($node->getReference()->getLabel()); if ($ref !== null) { // Use numeric title to get footnotes order $footnotes[(int) $ref->getTitle()] = $node; } else { // Footnote call is missing, append footnote at the end $footnotes[\PHP_INT_MAX] = $node; } $key = '#' . $this->config->get('footnote/footnote_id_prefix') . $node->getReference()->getDestination(); if ($document->data->has($key)) { $this->createBackrefs($node, $document->data->get($key)); } } // Only add a footnote container if there are any if (\count($footnotes) === 0) { return; } $container = $this->getFootnotesContainer($document); \ksort($footnotes); foreach ($footnotes as $footnote) { $container->appendChild($footnote); } } private function getFootnotesContainer(Document $document): FootnoteContainer { $footnoteContainer = new FootnoteContainer(); $document->appendChild($footnoteContainer); return $footnoteContainer; } /** * Look for all footnote refs pointing to this footnote and create each footnote backrefs. * * @param Footnote $node The target footnote * @param Reference[] $backrefs References to create backrefs for */ private function createBackrefs(Footnote $node, array $backrefs): void { // Backrefs should be added to the child paragraph $target = $node->lastChild(); if ($target === null) { // This should never happen, but you never know $target = $node; } foreach ($backrefs as $backref) { $target->appendChild(new FootnoteBackref(new Reference( $backref->getLabel(), '#' . $this->config->get('footnote/ref_id_prefix') . $backref->getLabel(), $backref->getTitle() ))); } } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } } PK ! ~��& & 4 Extension/Footnote/Event/NumberFootnotesListener.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Event; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\Footnote\Node\FootnoteRef; use League\CommonMark\Reference\Reference; final class NumberFootnotesListener { public function onDocumentParsed(DocumentParsedEvent $event): void { $document = $event->getDocument(); $nextCounter = 1; $usedLabels = []; $usedCounters = []; foreach ($document->iterator() as $node) { if (! $node instanceof FootnoteRef) { continue; } $existingReference = $node->getReference(); $label = $existingReference->getLabel(); $counter = $nextCounter; $canIncrementCounter = true; if (\array_key_exists($label, $usedLabels)) { /* * Reference is used again, we need to point * to the same footnote. But with a different ID */ $counter = $usedCounters[$label]; $label .= '__' . ++$usedLabels[$label]; $canIncrementCounter = false; } // rewrite reference title to use a numeric link $newReference = new Reference( $label, $existingReference->getDestination(), (string) $counter ); // Override reference with numeric link $node->setReference($newReference); $document->getReferenceMap()->add($newReference); /* * Store created references in document for * creating FootnoteBackrefs */ $document->data->append($existingReference->getDestination(), $newReference); $usedLabels[$label] = 1; $usedCounters[$label] = $nextCounter; if ($canIncrementCounter) { $nextCounter++; } } } } PK ! ��M�6 6 7 Extension/Footnote/Event/AnonymousFootnotesListener.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Event; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\Footnote\Node\Footnote; use League\CommonMark\Extension\Footnote\Node\FootnoteBackref; use League\CommonMark\Extension\Footnote\Node\FootnoteRef; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Reference\Reference; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class AnonymousFootnotesListener implements ConfigurationAwareInterface { private ConfigurationInterface $config; public function onDocumentParsed(DocumentParsedEvent $event): void { $document = $event->getDocument(); foreach ($document->iterator() as $node) { if (! $node instanceof FootnoteRef || ($text = $node->getContent()) === null) { continue; } // Anonymous footnote needs to create a footnote from its content $existingReference = $node->getReference(); $newReference = new Reference( $existingReference->getLabel(), '#' . $this->config->get('footnote/ref_id_prefix') . $existingReference->getLabel(), $existingReference->getTitle() ); $paragraph = new Paragraph(); $paragraph->appendChild(new Text($text)); $paragraph->appendChild(new FootnoteBackref($newReference)); $footnote = new Footnote($newReference); $footnote->appendChild($paragraph); $document->appendChild($footnote); } } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } } PK ! ��f�� � 3 Extension/Footnote/Renderer/FootnoteRefRenderer.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Renderer; use League\CommonMark\Extension\Footnote\Node\FootnoteRef; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class FootnoteRefRenderer implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface { private ConfigurationInterface $config; /** * @param FootnoteRef $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { FootnoteRef::assertInstanceOf($node); $attrs = $node->data->getData('attributes'); $attrs->append('class', $this->config->get('footnote/ref_class')); $attrs->set('href', \mb_strtolower($node->getReference()->getDestination(), 'UTF-8')); $attrs->set('role', 'doc-noteref'); $idPrefix = $this->config->get('footnote/ref_id_prefix'); return new HtmlElement( 'sup', [ 'id' => $idPrefix . \mb_strtolower($node->getReference()->getLabel(), 'UTF-8'), ], new HtmlElement( 'a', $attrs->export(), $node->getReference()->getTitle() ), true ); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } public function getXmlTagName(Node $node): string { return 'footnote_ref'; } /** * @param FootnoteRef $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { FootnoteRef::assertInstanceOf($node); return [ 'reference' => $node->getReference()->getLabel(), ]; } } PK ! /ڰ�A A 9 Extension/Footnote/Renderer/FootnoteContainerRenderer.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Renderer; use League\CommonMark\Extension\Footnote\Node\FootnoteContainer; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class FootnoteContainerRenderer implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface { private ConfigurationInterface $config; /** * @param FootnoteContainer $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { FootnoteContainer::assertInstanceOf($node); $attrs = $node->data->getData('attributes'); $attrs->append('class', $this->config->get('footnote/container_class')); $attrs->set('role', 'doc-endnotes'); $contents = new HtmlElement('ol', [], $childRenderer->renderNodes($node->children())); if ($this->config->get('footnote/container_add_hr')) { $contents = [new HtmlElement('hr', [], null, true), $contents]; } return new HtmlElement('div', $attrs->export(), $contents); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } public function getXmlTagName(Node $node): string { return 'footnote_container'; } /** * @return array<string, scalar> */ public function getXmlAttributes(Node $node): array { return []; } } PK ! �a�X X 7 Extension/Footnote/Renderer/FootnoteBackrefRenderer.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Renderer; use League\CommonMark\Extension\Footnote\Node\FootnoteBackref; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class FootnoteBackrefRenderer implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface { public const DEFAULT_SYMBOL = '↩'; private ConfigurationInterface $config; /** * @param FootnoteBackref $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): string { FootnoteBackref::assertInstanceOf($node); $attrs = $node->data->getData('attributes'); $attrs->append('class', $this->config->get('footnote/backref_class')); $attrs->set('rev', 'footnote'); $attrs->set('href', \mb_strtolower($node->getReference()->getDestination(), 'UTF-8')); $attrs->set('role', 'doc-backlink'); $symbol = $this->config->get('footnote/backref_symbol'); \assert(\is_string($symbol)); return ' ' . new HtmlElement('a', $attrs->export(), \htmlspecialchars($symbol), true); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } public function getXmlTagName(Node $node): string { return 'footnote_backref'; } /** * @param FootnoteBackref $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { FootnoteBackref::assertInstanceOf($node); return [ 'reference' => $node->getReference()->getLabel(), ]; } } PK ! )v@ � � 0 Extension/Footnote/Renderer/FootnoteRenderer.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Renderer; use League\CommonMark\Extension\Footnote\Node\Footnote; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class FootnoteRenderer implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface { private ConfigurationInterface $config; /** * @param Footnote $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { Footnote::assertInstanceOf($node); $attrs = $node->data->getData('attributes'); $attrs->append('class', $this->config->get('footnote/footnote_class')); $attrs->set('id', $this->config->get('footnote/footnote_id_prefix') . \mb_strtolower($node->getReference()->getLabel(), 'UTF-8')); $attrs->set('role', 'doc-endnote'); return new HtmlElement( 'li', $attrs->export(), $childRenderer->renderNodes($node->children()), true ); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } public function getXmlTagName(Node $node): string { return 'footnote'; } /** * @param Footnote $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { Footnote::assertInstanceOf($node); return [ 'reference' => $node->getReference()->getLabel(), ]; } } PK ! I�� 1 Extension/Footnote/Parser/FootnoteStartParser.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Parser; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; use League\CommonMark\Reference\Reference; use League\CommonMark\Util\RegexHelper; final class FootnoteStartParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { if ($cursor->isIndented() || $parserState->getLastMatchedBlockParser()->canHaveLazyContinuationLines()) { return BlockStart::none(); } $match = RegexHelper::matchFirst( '/^\[\^([^\s^\]]+)\]\:(?:\s|$)/', $cursor->getLine(), $cursor->getNextNonSpacePosition() ); if (! $match) { return BlockStart::none(); } $cursor->advanceToNextNonSpaceOrTab(); $cursor->advanceBy(\strlen($match[0])); $str = $cursor->getRemainder(); \preg_replace('/^\[\^([^\s^\]]+)\]\:(?:\s|$)/', '', $str); if (\preg_match('/^\[\^([^\s^\]]+)\]\:(?:\s|$)/', $match[0], $matches) !== 1) { return BlockStart::none(); } $reference = new Reference($matches[1], $matches[1], $matches[1]); $footnoteParser = new FootnoteParser($reference); return BlockStart::of($footnoteParser)->at($cursor); } } PK ! �zɎ� � / Extension/Footnote/Parser/FootnoteRefParser.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Parser; use League\CommonMark\Extension\Footnote\Node\FootnoteRef; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; use League\CommonMark\Reference\Reference; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class FootnoteRefParser implements InlineParserInterface, ConfigurationAwareInterface { private ConfigurationInterface $config; public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::regex('\[\^([^\s\]]+)\]'); } public function parse(InlineParserContext $inlineContext): bool { $inlineContext->getCursor()->advanceBy($inlineContext->getFullMatchLength()); [$label] = $inlineContext->getSubMatches(); $inlineContext->getContainer()->appendChild(new FootnoteRef($this->createReference($label))); return true; } private function createReference(string $label): Reference { return new Reference( $label, '#' . $this->config->get('footnote/footnote_id_prefix') . $label, $label ); } public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } } PK ! d�� , Extension/Footnote/Parser/FootnoteParser.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Parser; use League\CommonMark\Extension\Footnote\Node\Footnote; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Parser\Block\AbstractBlockContinueParser; use League\CommonMark\Parser\Block\BlockContinue; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Cursor; use League\CommonMark\Reference\ReferenceInterface; final class FootnoteParser extends AbstractBlockContinueParser { /** @psalm-readonly */ private Footnote $block; /** @psalm-readonly-allow-private-mutation */ private ?int $indentation = null; public function __construct(ReferenceInterface $reference) { $this->block = new Footnote($reference); } public function getBlock(): Footnote { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { if ($cursor->isBlank()) { return BlockContinue::at($cursor); } if ($cursor->isIndented()) { $this->indentation ??= $cursor->getIndent(); $cursor->advanceBy($this->indentation, true); return BlockContinue::at($cursor); } return BlockContinue::none(); } public function isContainer(): bool { return true; } public function canContain(AbstractBlock $childBlock): bool { return true; } } PK ! ��<zq q 8 Extension/Footnote/Parser/AnonymousFootnoteRefParser.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * (c) Rezo Zero / Ambroise Maupate * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Extension\Footnote\Parser; use League\CommonMark\Environment\EnvironmentAwareInterface; use League\CommonMark\Environment\EnvironmentInterface; use League\CommonMark\Extension\Footnote\Node\FootnoteRef; use League\CommonMark\Normalizer\TextNormalizerInterface; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; use League\CommonMark\Reference\Reference; use League\Config\ConfigurationInterface; final class AnonymousFootnoteRefParser implements InlineParserInterface, EnvironmentAwareInterface { private ConfigurationInterface $config; /** @psalm-readonly-allow-private-mutation */ private TextNormalizerInterface $slugNormalizer; public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::regex('\^\[([^\]]+)\]'); } public function parse(InlineParserContext $inlineContext): bool { $inlineContext->getCursor()->advanceBy($inlineContext->getFullMatchLength()); [$label] = $inlineContext->getSubMatches(); $reference = $this->createReference($label); $inlineContext->getContainer()->appendChild(new FootnoteRef($reference, $label)); return true; } private function createReference(string $label): Reference { $refLabel = $this->slugNormalizer->normalize($label, ['length' => 20]); return new Reference( $refLabel, '#' . $this->config->get('footnote/footnote_id_prefix') . $refLabel, $label ); } public function setEnvironment(EnvironmentInterface $environment): void { $this->config = $environment->getConfiguration(); $this->slugNormalizer = $environment->getSlugNormalizer(); } } PK ! ��� � - Extension/GithubFlavoredMarkdownExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Extension\Autolink\AutolinkExtension; use League\CommonMark\Extension\DisallowedRawHtml\DisallowedRawHtmlExtension; use League\CommonMark\Extension\Strikethrough\StrikethroughExtension; use League\CommonMark\Extension\Table\TableExtension; use League\CommonMark\Extension\TaskList\TaskListExtension; final class GithubFlavoredMarkdownExtension implements ExtensionInterface { public function register(EnvironmentBuilderInterface $environment): void { $environment->addExtension(new AutolinkExtension()); $environment->addExtension(new DisallowedRawHtmlExtension()); $environment->addExtension(new StrikethroughExtension()); $environment->addExtension(new TableExtension()); $environment->addExtension(new TaskListExtension()); } } PK ! �C@� � 7 Extension/HeadingPermalink/HeadingPermalinkRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\HeadingPermalink; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; /** * Renders the HeadingPermalink elements */ final class HeadingPermalinkRenderer implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface { public const DEFAULT_SYMBOL = '¶'; /** @psalm-readonly-allow-private-mutation */ private ConfigurationInterface $config; public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } /** * @param HeadingPermalink $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { HeadingPermalink::assertInstanceOf($node); $slug = $node->getSlug(); $fragmentPrefix = (string) $this->config->get('heading_permalink/fragment_prefix'); if ($fragmentPrefix !== '') { $fragmentPrefix .= '-'; } $attrs = $node->data->getData('attributes'); $appendId = ! $this->config->get('heading_permalink/apply_id_to_heading'); if ($appendId) { $idPrefix = (string) $this->config->get('heading_permalink/id_prefix'); if ($idPrefix !== '') { $idPrefix .= '-'; } $attrs->set('id', $idPrefix . $slug); } $attrs->set('href', '#' . $fragmentPrefix . $slug); $attrs->append('class', $this->config->get('heading_permalink/html_class')); $hidden = $this->config->get('heading_permalink/aria_hidden'); if ($hidden) { $attrs->set('aria-hidden', 'true'); } $attrs->set('title', $this->config->get('heading_permalink/title')); $symbol = $this->config->get('heading_permalink/symbol'); \assert(\is_string($symbol)); return new HtmlElement('a', $attrs->export(), \htmlspecialchars($symbol), false); } public function getXmlTagName(Node $node): string { return 'heading_permalink'; } /** * @param HeadingPermalink $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { HeadingPermalink::assertInstanceOf($node); return [ 'slug' => $node->getSlug(), ]; } } PK ! rE{�� � / Extension/HeadingPermalink/HeadingPermalink.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\HeadingPermalink; use League\CommonMark\Node\Inline\AbstractInline; /** * Represents an anchor link within a heading */ final class HeadingPermalink extends AbstractInline { /** @psalm-readonly */ private string $slug; public function __construct(string $slug) { parent::__construct(); $this->slug = $slug; } public function getSlug(): string { return $this->slug; } } PK ! ��� � 8 Extension/HeadingPermalink/HeadingPermalinkProcessor.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\HeadingPermalink; use League\CommonMark\Environment\EnvironmentAwareInterface; use League\CommonMark\Environment\EnvironmentInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\CommonMark\Node\Block\Heading; use League\CommonMark\Node\NodeIterator; use League\CommonMark\Node\RawMarkupContainerInterface; use League\CommonMark\Node\StringContainerHelper; use League\CommonMark\Normalizer\TextNormalizerInterface; use League\Config\ConfigurationInterface; use League\Config\Exception\InvalidConfigurationException; /** * Searches the Document for Heading elements and adds HeadingPermalinks to each one */ final class HeadingPermalinkProcessor implements EnvironmentAwareInterface { public const INSERT_BEFORE = 'before'; public const INSERT_AFTER = 'after'; public const INSERT_NONE = 'none'; /** @psalm-readonly-allow-private-mutation */ private TextNormalizerInterface $slugNormalizer; /** @psalm-readonly-allow-private-mutation */ private ConfigurationInterface $config; public function setEnvironment(EnvironmentInterface $environment): void { $this->config = $environment->getConfiguration(); $this->slugNormalizer = $environment->getSlugNormalizer(); } public function __invoke(DocumentParsedEvent $e): void { $min = (int) $this->config->get('heading_permalink/min_heading_level'); $max = (int) $this->config->get('heading_permalink/max_heading_level'); $applyToHeading = (bool) $this->config->get('heading_permalink/apply_id_to_heading'); $idPrefix = (string) $this->config->get('heading_permalink/id_prefix'); $slugLength = (int) $this->config->get('slug_normalizer/max_length'); $headingClass = (string) $this->config->get('heading_permalink/heading_class'); if ($idPrefix !== '') { $idPrefix .= '-'; } foreach ($e->getDocument()->iterator(NodeIterator::FLAG_BLOCKS_ONLY) as $node) { if ($node instanceof Heading && $node->getLevel() >= $min && $node->getLevel() <= $max) { $this->addHeadingLink($node, $slugLength, $idPrefix, $applyToHeading, $headingClass); } } } private function addHeadingLink(Heading $heading, int $slugLength, string $idPrefix, bool $applyToHeading, string $headingClass): void { $text = StringContainerHelper::getChildText($heading, [RawMarkupContainerInterface::class]); $slug = $this->slugNormalizer->normalize($text, [ 'node' => $heading, 'length' => $slugLength, ]); if ($applyToHeading) { $heading->data->set('attributes/id', $idPrefix . $slug); } if ($headingClass !== '') { $heading->data->append('attributes/class', $headingClass); } $headingLinkAnchor = new HeadingPermalink($slug); switch ($this->config->get('heading_permalink/insert')) { case self::INSERT_BEFORE: $heading->prependChild($headingLinkAnchor); return; case self::INSERT_AFTER: $heading->appendChild($headingLinkAnchor); return; case self::INSERT_NONE: return; default: throw new InvalidConfigurationException("Invalid configuration value for heading_permalink/insert; expected 'before', 'after', or 'none'"); } } } PK ! �CO�S S 8 Extension/HeadingPermalink/HeadingPermalinkExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\HeadingPermalink; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; /** * Extension which automatically anchor links to heading elements */ final class HeadingPermalinkExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $builder->addSchema('heading_permalink', Expect::structure([ 'min_heading_level' => Expect::int()->min(1)->max(6)->default(1), 'max_heading_level' => Expect::int()->min(1)->max(6)->default(6), 'insert' => Expect::anyOf(HeadingPermalinkProcessor::INSERT_BEFORE, HeadingPermalinkProcessor::INSERT_AFTER, HeadingPermalinkProcessor::INSERT_NONE)->default(HeadingPermalinkProcessor::INSERT_BEFORE), 'id_prefix' => Expect::string()->default('content'), 'apply_id_to_heading' => Expect::bool()->default(false), 'heading_class' => Expect::string()->default(''), 'fragment_prefix' => Expect::string()->default('content'), 'html_class' => Expect::string()->default('heading-permalink'), 'title' => Expect::string()->default('Permalink'), 'symbol' => Expect::string()->default(HeadingPermalinkRenderer::DEFAULT_SYMBOL), 'aria_hidden' => Expect::bool()->default(true), ])); } public function register(EnvironmentBuilderInterface $environment): void { $environment->addEventListener(DocumentParsedEvent::class, new HeadingPermalinkProcessor(), -100); $environment->addRenderer(HeadingPermalink::class, new HeadingPermalinkRenderer()); } } PK ! ��Тr r # Extension/SmartPunct/DashParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (http://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\SmartPunct; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; final class DashParser implements InlineParserInterface { private const EN_DASH = '–'; private const EM_DASH = '—'; public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::regex('(?<!-)(-{2,})'); } public function parse(InlineParserContext $inlineContext): bool { $count = $inlineContext->getFullMatchLength(); $inlineContext->getCursor()->advanceBy($count); $enCount = 0; $emCount = 0; if ($count % 3 === 0) { // If divisible by 3, use all em dashes $emCount = (int) ($count / 3); } elseif ($count % 2 === 0) { // If divisible by 2, use all en dashes $enCount = (int) ($count / 2); } elseif ($count % 3 === 2) { // If 2 extra dashes, use en dash for last 2; em dashes for rest $emCount = (int) (($count - 2) / 3); $enCount = 1; } else { // Use en dashes for last 4 hyphens; em dashes for rest $emCount = (int) (($count - 4) / 3); $enCount = 2; } $inlineContext->getContainer()->appendChild(new Text( \str_repeat(self::EM_DASH, $emCount) . \str_repeat(self::EN_DASH, $enCount) )); return true; } } PK ! � 4$O O ' Extension/SmartPunct/EllipsesParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (http://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\SmartPunct; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; final class EllipsesParser implements InlineParserInterface { public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::oneOf('...', '. . .'); } public function parse(InlineParserContext $inlineContext): bool { $inlineContext->getCursor()->advanceBy($inlineContext->getFullMatchLength()); $inlineContext->getContainer()->appendChild(new Text('…')); return true; } } PK ! �%�d; ; ' Extension/SmartPunct/QuoteProcessor.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (http://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\SmartPunct; use League\CommonMark\Delimiter\DelimiterInterface; use League\CommonMark\Delimiter\Processor\DelimiterProcessorInterface; use League\CommonMark\Node\Inline\AbstractStringContainer; final class QuoteProcessor implements DelimiterProcessorInterface { /** @psalm-readonly */ private string $normalizedCharacter; /** @psalm-readonly */ private string $openerCharacter; /** @psalm-readonly */ private string $closerCharacter; private function __construct(string $char, string $opener, string $closer) { $this->normalizedCharacter = $char; $this->openerCharacter = $opener; $this->closerCharacter = $closer; } public function getOpeningCharacter(): string { return $this->normalizedCharacter; } public function getClosingCharacter(): string { return $this->normalizedCharacter; } public function getMinLength(): int { return 1; } public function getDelimiterUse(DelimiterInterface $opener, DelimiterInterface $closer): int { return 1; } public function process(AbstractStringContainer $opener, AbstractStringContainer $closer, int $delimiterUse): void { $opener->insertAfter(new Quote($this->openerCharacter)); $closer->insertBefore(new Quote($this->closerCharacter)); } /** * Create a double-quote processor */ public static function createDoubleQuoteProcessor(string $opener = Quote::DOUBLE_QUOTE_OPENER, string $closer = Quote::DOUBLE_QUOTE_CLOSER): self { return new self(Quote::DOUBLE_QUOTE, $opener, $closer); } /** * Create a single-quote processor */ public static function createSingleQuoteProcessor(string $opener = Quote::SINGLE_QUOTE_OPENER, string $closer = Quote::SINGLE_QUOTE_CLOSER): self { return new self(Quote::SINGLE_QUOTE, $opener, $closer); } } PK ! �=u�� � $ Extension/SmartPunct/QuoteParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (http://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\SmartPunct; use League\CommonMark\Delimiter\Delimiter; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; use League\CommonMark\Util\RegexHelper; final class QuoteParser implements InlineParserInterface { /** * @deprecated This constant is no longer used and will be removed in a future major release */ public const DOUBLE_QUOTES = [Quote::DOUBLE_QUOTE, Quote::DOUBLE_QUOTE_OPENER, Quote::DOUBLE_QUOTE_CLOSER]; /** * @deprecated This constant is no longer used and will be removed in a future major release */ public const SINGLE_QUOTES = [Quote::SINGLE_QUOTE, Quote::SINGLE_QUOTE_OPENER, Quote::SINGLE_QUOTE_CLOSER]; public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::oneOf(Quote::SINGLE_QUOTE, Quote::DOUBLE_QUOTE); } /** * Normalizes any quote characters found and manually adds them to the delimiter stack */ public function parse(InlineParserContext $inlineContext): bool { $char = $inlineContext->getFullMatch(); $cursor = $inlineContext->getCursor(); $charBefore = $cursor->peek(-1); if ($charBefore === null) { $charBefore = "\n"; } $cursor->advance(); $charAfter = $cursor->getCurrentCharacter(); if ($charAfter === null) { $charAfter = "\n"; } [$leftFlanking, $rightFlanking] = $this->determineFlanking($charBefore, $charAfter); $canOpen = $leftFlanking && ! $rightFlanking; $canClose = $rightFlanking; $node = new Quote($char, ['delim' => true]); $inlineContext->getContainer()->appendChild($node); // Add entry to stack to this opener $inlineContext->getDelimiterStack()->push(new Delimiter($char, 1, $node, $canOpen, $canClose)); return true; } /** * @return bool[] */ private function determineFlanking(string $charBefore, string $charAfter): array { $afterIsWhitespace = \preg_match('/\pZ|\s/u', $charAfter); $afterIsPunctuation = \preg_match(RegexHelper::REGEX_PUNCTUATION, $charAfter); $beforeIsWhitespace = \preg_match('/\pZ|\s/u', $charBefore); $beforeIsPunctuation = \preg_match(RegexHelper::REGEX_PUNCTUATION, $charBefore); $leftFlanking = ! $afterIsWhitespace && ! ($afterIsPunctuation && ! $beforeIsWhitespace && ! $beforeIsPunctuation); $rightFlanking = ! $beforeIsWhitespace && ! ($beforeIsPunctuation && ! $afterIsWhitespace && ! $afterIsPunctuation); return [$leftFlanking, $rightFlanking]; } } PK ! �K�{A A Extension/SmartPunct/Quote.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (http://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\SmartPunct; use League\CommonMark\Node\Inline\AbstractStringContainer; final class Quote extends AbstractStringContainer { public const DOUBLE_QUOTE = '"'; public const DOUBLE_QUOTE_OPENER = '“'; public const DOUBLE_QUOTE_CLOSER = '”'; public const SINGLE_QUOTE = "'"; public const SINGLE_QUOTE_OPENER = '‘'; public const SINGLE_QUOTE_CLOSER = '’'; } PK ! �mk�2 2 6 Extension/SmartPunct/ReplaceUnpairedQuotesListener.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\SmartPunct; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Node\Inline\AdjacentTextMerger; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Node\Query; /** * Identifies any lingering Quote nodes that were missing pairs and converts them into Text nodes */ final class ReplaceUnpairedQuotesListener { public function __invoke(DocumentParsedEvent $event): void { $query = (new Query())->where(Query::type(Quote::class)); foreach ($query->findAll($event->getDocument()) as $quote) { \assert($quote instanceof Quote); $literal = $quote->getLiteral(); if ($literal === Quote::SINGLE_QUOTE) { $literal = Quote::SINGLE_QUOTE_CLOSER; } elseif ($literal === Quote::DOUBLE_QUOTE) { $literal = Quote::DOUBLE_QUOTE_OPENER; } $quote->replaceWith($new = new Text($literal)); AdjacentTextMerger::mergeWithDirectlyAdjacentNodes($new); } } } PK ! 2"�?� � , Extension/SmartPunct/SmartPunctExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (http://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\SmartPunct; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\CommonMark\Node\Block\Document; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Renderer\Block as CoreBlockRenderer; use League\CommonMark\Renderer\Inline as CoreInlineRenderer; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; final class SmartPunctExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $builder->addSchema('smartpunct', Expect::structure([ 'double_quote_opener' => Expect::string(Quote::DOUBLE_QUOTE_OPENER), 'double_quote_closer' => Expect::string(Quote::DOUBLE_QUOTE_CLOSER), 'single_quote_opener' => Expect::string(Quote::SINGLE_QUOTE_OPENER), 'single_quote_closer' => Expect::string(Quote::SINGLE_QUOTE_CLOSER), ])); } public function register(EnvironmentBuilderInterface $environment): void { $environment ->addInlineParser(new QuoteParser(), 10) ->addInlineParser(new DashParser(), 0) ->addInlineParser(new EllipsesParser(), 0) ->addDelimiterProcessor(QuoteProcessor::createDoubleQuoteProcessor( $environment->getConfiguration()->get('smartpunct/double_quote_opener'), $environment->getConfiguration()->get('smartpunct/double_quote_closer') )) ->addDelimiterProcessor(QuoteProcessor::createSingleQuoteProcessor( $environment->getConfiguration()->get('smartpunct/single_quote_opener'), $environment->getConfiguration()->get('smartpunct/single_quote_closer') )) ->addEventListener(DocumentParsedEvent::class, new ReplaceUnpairedQuotesListener()) ->addRenderer(Document::class, new CoreBlockRenderer\DocumentRenderer(), 0) ->addRenderer(Paragraph::class, new CoreBlockRenderer\ParagraphRenderer(), 0) ->addRenderer(Text::class, new CoreInlineRenderer\TextRenderer(), 0); } } PK ! Aʍ� ( Extension/Autolink/UrlAutolinkParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Autolink; use League\CommonMark\Extension\CommonMark\Node\Inline\Link; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; final class UrlAutolinkParser implements InlineParserInterface { private const ALLOWED_AFTER = [null, ' ', "\t", "\n", "\x0b", "\x0c", "\x0d", '*', '_', '~', '(']; // RegEx adapted from https://github.com/symfony/symfony/blob/6.3/src/Symfony/Component/Validator/Constraints/UrlValidator.php private const REGEX = '~ ( # Must start with a supported scheme + auth, or "www" (?: (?:%s):// # protocol (?:(?:(?:[\_\.\pL\pN-]|%%[0-9A-Fa-f]{2})+:)?((?:[\_\.\pL\pN-]|%%[0-9A-Fa-f]{2})+)@)? # basic auth |www\.) (?: (?: (?:xn--[a-z0-9-]++\.)*+xn--[a-z0-9-]++ # a domain name using punycode | (?:[\pL\pN\pS\pM\-\_]++\.)+[\pL\pN\pM]++ # a multi-level domain name | [a-z0-9\-\_]++ # a single-level domain name )\.? | # or \d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3} # an IP address | # or \[ (?:(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){6})(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:::(?:(?:(?:[0-9a-f]{1,4})):){5})(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:[0-9a-f]{1,4})))?::(?:(?:(?:[0-9a-f]{1,4})):){4})(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,1}(?:(?:[0-9a-f]{1,4})))?::(?:(?:(?:[0-9a-f]{1,4})):){3})(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,2}(?:(?:[0-9a-f]{1,4})))?::(?:(?:(?:[0-9a-f]{1,4})):){2})(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,3}(?:(?:[0-9a-f]{1,4})))?::(?:(?:[0-9a-f]{1,4})):)(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,4}(?:(?:[0-9a-f]{1,4})))?::)(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,5}(?:(?:[0-9a-f]{1,4})))?::)(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,6}(?:(?:[0-9a-f]{1,4})))?::)))) \] # an IPv6 address ) (?::[0-9]+)? # a port (optional) (?:/ (?:[\pL\pN\-._\~!$&\'()*+,;=:@]|%%[0-9A-Fa-f]{2})* )* # a path (?:\? (?:[\pL\pN\-._\~!$&\'\[\]()*+,;=:@/?]|%%[0-9A-Fa-f]{2})* )? # a query (optional) (?:\# (?:[\pL\pN\-._\~!$&\'()*+,;=:@/?]|%%[0-9A-Fa-f]{2})* )? # a fragment (optional) )~ixu'; /** * @var string[] * * @psalm-readonly */ private array $prefixes = ['www.']; /** * @psalm-var non-empty-string * * @psalm-readonly */ private string $finalRegex; private string $defaultProtocol; /** * @param array<int, string> $allowedProtocols */ public function __construct(array $allowedProtocols = ['http', 'https', 'ftp'], string $defaultProtocol = 'http') { /** * @psalm-suppress PropertyTypeCoercion */ $this->finalRegex = \sprintf(self::REGEX, \implode('|', $allowedProtocols)); foreach ($allowedProtocols as $protocol) { $this->prefixes[] = $protocol . '://'; } $this->defaultProtocol = $defaultProtocol; } public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::oneOf(...$this->prefixes); } public function parse(InlineParserContext $inlineContext): bool { $cursor = $inlineContext->getCursor(); // Autolinks can only come at the beginning of a line, after whitespace, or certain delimiting characters $previousChar = $cursor->peek(-1); if (! \in_array($previousChar, self::ALLOWED_AFTER, true)) { return false; } // Check if we have a valid URL if (! \preg_match($this->finalRegex, $cursor->getRemainder(), $matches)) { return false; } $url = $matches[0]; // Does the URL end with punctuation that should be stripped? if (\preg_match('/(.+?)([?!.,:*_~]+)$/', $url, $matches)) { // Add the punctuation later $url = $matches[1]; } // Does the URL end with something that looks like an entity reference? if (\preg_match('/(.+)(&[A-Za-z0-9]+;)$/', $url, $matches)) { $url = $matches[1]; } // Does the URL need unmatched parens chopped off? if (\substr($url, -1) === ')' && ($diff = self::diffParens($url)) > 0) { $url = \substr($url, 0, -$diff); } $cursor->advanceBy(\mb_strlen($url, 'UTF-8')); // Auto-prefix 'http(s)://' onto 'www' URLs if (\substr($url, 0, 4) === 'www.') { $inlineContext->getContainer()->appendChild(new Link($this->defaultProtocol . '://' . $url, $url)); return true; } $inlineContext->getContainer()->appendChild(new Link($url, $url)); return true; } /** * @psalm-pure */ private static function diffParens(string $content): int { // Scan the entire autolink for the total number of parentheses. // If there is a greater number of closing parentheses than opening ones, // we don’t consider ANY of the last characters as part of the autolink, // in order to facilitate including an autolink inside a parenthesis. \preg_match_all('/[()]/', $content, $matches); $charCount = ['(' => 0, ')' => 0]; foreach ($matches[0] as $char) { $charCount[$char]++; } return $charCount[')'] - $charCount['(']; } } PK ! -ʨ�? ? ( Extension/Autolink/AutolinkExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Autolink; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\Config\ConfigurationBuilderInterface; use Nette\Schema\Expect; final class AutolinkExtension implements ConfigurableExtensionInterface { public function configureSchema(ConfigurationBuilderInterface $builder): void { $builder->addSchema('autolink', Expect::structure([ 'allowed_protocols' => Expect::listOf('string')->default(['http', 'https', 'ftp'])->mergeDefaults(false), 'default_protocol' => Expect::string()->default('http'), ])); } public function register(EnvironmentBuilderInterface $environment): void { $environment->addInlineParser(new EmailAutolinkParser()); $environment->addInlineParser(new UrlAutolinkParser( $environment->getConfiguration()->get('autolink.allowed_protocols'), $environment->getConfiguration()->get('autolink.default_protocol'), )); } } PK ! �_��� � * Extension/Autolink/EmailAutolinkParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\Autolink; use League\CommonMark\Extension\CommonMark\Node\Inline\Link; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; final class EmailAutolinkParser implements InlineParserInterface { private const REGEX = '[A-Za-z0-9.\-_+]+@[A-Za-z0-9\-_]+\.[A-Za-z0-9\-_.]+'; public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::regex(self::REGEX); } public function parse(InlineParserContext $inlineContext): bool { $email = $inlineContext->getFullMatch(); // The last character cannot be - or _ if (\in_array(\substr($email, -1), ['-', '_'], true)) { return false; } // Does the URL end with punctuation that should be stripped? if (\substr($email, -1) === '.') { $email = \substr($email, 0, -1); } $inlineContext->getCursor()->advanceBy(\strlen($email)); $inlineContext->getContainer()->appendChild(new Link('mailto:' . $email, $email)); return true; } } PK ! ���c c Extension/ExtensionInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension; use League\CommonMark\Environment\EnvironmentBuilderInterface; interface ExtensionInterface { public function register(EnvironmentBuilderInterface $environment): void; } PK ! ,��� � ( Extension/TaskList/TaskListExtension.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TaskList; use League\CommonMark\Environment\EnvironmentBuilderInterface; use League\CommonMark\Extension\ExtensionInterface; final class TaskListExtension implements ExtensionInterface { public function register(EnvironmentBuilderInterface $environment): void { $environment->addInlineParser(new TaskListItemMarkerParser(), 35); $environment->addRenderer(TaskListItemMarker::class, new TaskListItemMarkerRenderer()); } } PK ! �-��8 8 ) Extension/TaskList/TaskListItemMarker.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TaskList; use League\CommonMark\Node\Inline\AbstractInline; final class TaskListItemMarker extends AbstractInline { /** @psalm-readonly-allow-private-mutation */ private bool $checked; public function __construct(bool $isCompleted) { parent::__construct(); $this->checked = $isCompleted; } public function isChecked(): bool { return $this->checked; } public function setChecked(bool $checked): void { $this->checked = $checked; } } PK ! "��MY Y / Extension/TaskList/TaskListItemMarkerParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TaskList; use League\CommonMark\Extension\CommonMark\Node\Block\ListItem; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Parser\Inline\InlineParserMatch; use League\CommonMark\Parser\InlineParserContext; final class TaskListItemMarkerParser implements InlineParserInterface { public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::oneOf('[ ]', '[x]'); } public function parse(InlineParserContext $inlineContext): bool { $container = $inlineContext->getContainer(); // Checkbox must come at the beginning of the first paragraph of the list item if ($container->hasChildren() || ! ($container instanceof Paragraph && $container->parent() && $container->parent() instanceof ListItem)) { return false; } $cursor = $inlineContext->getCursor(); $oldState = $cursor->saveState(); $cursor->advanceBy(3); if ($cursor->getNextNonSpaceCharacter() === null) { $cursor->restoreState($oldState); return false; } $isChecked = $inlineContext->getFullMatch() !== '[ ]'; $container->appendChild(new TaskListItemMarker($isChecked)); return true; } } PK ! �7� 1 Extension/TaskList/TaskListItemMarkerRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Extension\TaskList; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class TaskListItemMarkerRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param TaskListItemMarker $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \Stringable { TaskListItemMarker::assertInstanceOf($node); $attrs = $node->data->get('attributes'); $checkbox = new HtmlElement('input', $attrs, '', true); if ($node->isChecked()) { $checkbox->setAttribute('checked', ''); } $checkbox->setAttribute('disabled', ''); $checkbox->setAttribute('type', 'checkbox'); return $checkbox; } public function getXmlTagName(Node $node): string { return 'task_list_item_marker'; } /** * @param TaskListItemMarker $node * * @return array<string, scalar> * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlAttributes(Node $node): array { TaskListItemMarker::assertInstanceOf($node); if ($node->isChecked()) { return ['checked' => 'checked']; } return []; } } PK ! 5��� � Node/Query.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node; use League\CommonMark\Node\Query\AndExpr; use League\CommonMark\Node\Query\OrExpr; final class Query { /** @var callable(Node): bool $condition */ private $condition; public function __construct() { $this->condition = new AndExpr(); } public function where(callable ...$conditions): self { return $this->andWhere(...$conditions); } public function andWhere(callable ...$conditions): self { if ($this->condition instanceof AndExpr) { foreach ($conditions as $condition) { $this->condition->add($condition); } } else { $this->condition = new AndExpr($this->condition, ...$conditions); } return $this; } public function orWhere(callable ...$conditions): self { if ($this->condition instanceof OrExpr) { foreach ($conditions as $condition) { $this->condition->add($condition); } } else { $this->condition = new OrExpr($this->condition, ...$conditions); } return $this; } public function findOne(Node $node): ?Node { foreach ($node->iterator() as $n) { if (\call_user_func($this->condition, $n)) { return $n; } } return null; } /** * @return iterable<Node> */ public function findAll(Node $node, ?int $limit = PHP_INT_MAX): iterable { $resultCount = 0; foreach ($node->iterator() as $n) { if ($resultCount >= $limit) { break; } if (! \call_user_func($this->condition, $n)) { continue; } ++$resultCount; yield $n; } } /** * @return callable(Node): bool */ public static function type(string $class): callable { return static fn (Node $node): bool => $node instanceof $class; } /** * @psalm-param ?callable(Node): bool $condition * * @return callable(Node): bool */ public static function hasChild(?callable $condition = null): callable { return static function (Node $node) use ($condition): bool { foreach ($node->children() as $child) { if ($condition === null || $condition($child)) { return true; } } return false; }; } /** * @psalm-param ?callable(Node): bool $condition * * @return callable(Node): bool */ public static function hasParent(?callable $condition = null): callable { return static function (Node $node) use ($condition): bool { $parent = $node->parent(); if ($parent === null) { return false; } if ($condition === null) { return true; } return $condition($parent); }; } } PK ! 2ސ� � $ Node/RawMarkupContainerInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node; /** * Interface for a node which contains raw, unprocessed markup (like HTML) */ interface RawMarkupContainerInterface extends StringContainerInterface { } PK ! w� ]� � " Node/Query/ExpressionInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Query; use League\CommonMark\Node\Node; interface ExpressionInterface { public function __invoke(Node $node): bool; } PK ! h��Wn n Node/Query/AndExpr.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Query; use League\CommonMark\Node\Node; /** * @internal */ final class AndExpr implements ExpressionInterface { /** * @var callable[] * @psalm-var list<callable(Node): bool> */ private array $conditions; /** * @psalm-param callable(Node): bool $expressions */ public function __construct(callable ...$expressions) { $this->conditions = \array_values($expressions); } /** * @param callable(Node): bool $expression */ public function add(callable $expression): void { $this->conditions[] = $expression; } public function __invoke(Node $node): bool { foreach ($this->conditions as $condition) { if (! $condition($node)) { return false; } } return true; } } PK ! sW�k k Node/Query/OrExpr.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Query; use League\CommonMark\Node\Node; /** * @internal */ final class OrExpr implements ExpressionInterface { /** * @var callable[] * @psalm-var list<callable(Node): bool> */ private array $conditions; /** * @psalm-param callable(Node): bool $expressions */ public function __construct(callable ...$expressions) { $this->conditions = \array_values($expressions); } /** * @param callable(Node): bool $expression */ public function add(callable $expression): void { $this->conditions[] = $expression; } public function __invoke(Node $node): bool { foreach ($this->conditions as $condition) { if ($condition($node)) { return true; } } return false; } } PK ! �j4L L Node/StringContainerHelper.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node; final class StringContainerHelper { /** * Extract text literals from all descendant nodes * * @param Node $node Parent node * @param array<string> $excludeTypes Optional list of node class types to exclude * * @return string Concatenated literals */ public static function getChildText(Node $node, array $excludeTypes = []): string { $text = ''; foreach ($node->iterator() as $child) { if ($child instanceof StringContainerInterface && ! self::isOneOf($child, $excludeTypes)) { $text .= $child->getLiteral(); } } return $text; } /** * @param string[] $classesOrInterfacesToCheck * * @psalm-pure */ private static function isOneOf(object $object, array $classesOrInterfacesToCheck): bool { foreach ($classesOrInterfacesToCheck as $type) { if ($object instanceof $type) { return true; } } return false; } } PK ! ��0b b Node/NodeIterator.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node; use League\CommonMark\Node\Block\AbstractBlock; /** * @implements \IteratorAggregate<int, Node> */ final class NodeIterator implements \IteratorAggregate { public const FLAG_BLOCKS_ONLY = 1; private Node $node; private bool $blocksOnly; public function __construct(Node $node, int $flags = 0) { $this->node = $node; $this->blocksOnly = ($flags & self::FLAG_BLOCKS_ONLY) === self::FLAG_BLOCKS_ONLY; } /** * @return \Generator<int, Node> */ public function getIterator(): \Generator { $stack = [$this->node]; $index = 0; while ($stack) { $node = \array_pop($stack); yield $index++ => $node; // Push all children onto the stack in reverse order $child = $node->lastChild(); while ($child !== null) { if (! $this->blocksOnly || $child instanceof AbstractBlock) { $stack[] = $child; } $child = $child->previous(); } } } } PK ! ���B B Node/Node.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node; use Dflydev\DotAccessData\Data; use League\CommonMark\Exception\InvalidArgumentException; abstract class Node { /** @psalm-readonly */ public Data $data; /** @psalm-readonly-allow-private-mutation */ protected int $depth = 0; /** @psalm-readonly-allow-private-mutation */ protected ?Node $parent = null; /** @psalm-readonly-allow-private-mutation */ protected ?Node $previous = null; /** @psalm-readonly-allow-private-mutation */ protected ?Node $next = null; /** @psalm-readonly-allow-private-mutation */ protected ?Node $firstChild = null; /** @psalm-readonly-allow-private-mutation */ protected ?Node $lastChild = null; public function __construct() { $this->data = new Data([ 'attributes' => [], ]); } public function previous(): ?Node { return $this->previous; } public function next(): ?Node { return $this->next; } public function parent(): ?Node { return $this->parent; } protected function setParent(?Node $node = null): void { $this->parent = $node; $this->depth = $node === null ? 0 : $node->depth + 1; } /** * Inserts the $sibling node after $this */ public function insertAfter(Node $sibling): void { $sibling->detach(); $sibling->next = $this->next; if ($sibling->next) { $sibling->next->previous = $sibling; } $sibling->previous = $this; $this->next = $sibling; $sibling->setParent($this->parent); if (! $sibling->next && $sibling->parent) { $sibling->parent->lastChild = $sibling; } } /** * Inserts the $sibling node before $this */ public function insertBefore(Node $sibling): void { $sibling->detach(); $sibling->previous = $this->previous; if ($sibling->previous) { $sibling->previous->next = $sibling; } $sibling->next = $this; $this->previous = $sibling; $sibling->setParent($this->parent); if (! $sibling->previous && $sibling->parent) { $sibling->parent->firstChild = $sibling; } } public function replaceWith(Node $replacement): void { $replacement->detach(); $this->insertAfter($replacement); $this->detach(); } public function detach(): void { if ($this->previous) { $this->previous->next = $this->next; } elseif ($this->parent) { $this->parent->firstChild = $this->next; } if ($this->next) { $this->next->previous = $this->previous; } elseif ($this->parent) { $this->parent->lastChild = $this->previous; } $this->parent = null; $this->next = null; $this->previous = null; $this->depth = 0; } public function hasChildren(): bool { return $this->firstChild !== null; } public function firstChild(): ?Node { return $this->firstChild; } public function lastChild(): ?Node { return $this->lastChild; } /** * @return Node[] */ public function children(): iterable { $children = []; for ($current = $this->firstChild; $current !== null; $current = $current->next) { $children[] = $current; } return $children; } public function appendChild(Node $child): void { if ($this->lastChild) { $this->lastChild->insertAfter($child); } else { $child->detach(); $child->setParent($this); $this->lastChild = $this->firstChild = $child; } } /** * Adds $child as the very first child of $this */ public function prependChild(Node $child): void { if ($this->firstChild) { $this->firstChild->insertBefore($child); } else { $child->detach(); $child->setParent($this); $this->lastChild = $this->firstChild = $child; } } /** * Detaches all child nodes of given node */ public function detachChildren(): void { foreach ($this->children() as $children) { $children->setParent(null); } $this->firstChild = $this->lastChild = null; } /** * Replace all children of given node with collection of another * * @param iterable<Node> $children */ public function replaceChildren(iterable $children): void { $this->detachChildren(); foreach ($children as $item) { $this->appendChild($item); } } public function getDepth(): int { return $this->depth; } public function walker(): NodeWalker { return new NodeWalker($this); } public function iterator(int $flags = 0): NodeIterator { return new NodeIterator($this, $flags); } /** * Clone the current node and its children * * WARNING: This is a recursive function and should not be called on deeply-nested node trees! */ public function __clone() { // Cloned nodes are detached from their parents, siblings, and children $this->parent = null; $this->previous = null; $this->next = null; // But save a copy of the children since we'll need that in a moment $children = $this->children(); $this->detachChildren(); // The original children get cloned and re-added foreach ($children as $child) { $this->appendChild(clone $child); } } public static function assertInstanceOf(Node $node): void { if (! $node instanceof static) { throw new InvalidArgumentException(\sprintf('Incompatible node type: expected %s, got %s', static::class, \get_class($node))); } } } PK ! P3�0 Node/Inline/AbstractInline.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Inline; use League\CommonMark\Node\Node; abstract class AbstractInline extends Node { } PK ! ���~� � " Node/Inline/AdjacentTextMerger.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java) * - (c) Atlassian Pty Ltd * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Inline; use League\CommonMark\Node\Node; /** * @internal */ final class AdjacentTextMerger { public static function mergeChildNodes(Node $node): void { // No children or just one child node, no need for merging if ($node->firstChild() === $node->lastChild() || $node->firstChild() === null || $node->lastChild() === null) { return; } /** @psalm-suppress PossiblyNullArgument */ self::mergeTextNodesInclusive($node->firstChild(), $node->lastChild()); } public static function mergeTextNodesBetweenExclusive(Node $fromNode, Node $toNode): void { // No nodes between them if ($fromNode === $toNode || $fromNode->next() === $toNode || $fromNode->next() === null || $toNode->previous() === null) { return; } /** @psalm-suppress PossiblyNullArgument */ self::mergeTextNodesInclusive($fromNode->next(), $toNode->previous()); } public static function mergeWithDirectlyAdjacentNodes(Text $node): void { $start = ($previous = $node->previous()) instanceof Text ? $previous : $node; $end = ($next = $node->next()) instanceof Text ? $next : $node; self::mergeIfNeeded($start, $end); } private static function mergeTextNodesInclusive(Node $fromNode, Node $toNode): void { $first = null; $last = null; $node = $fromNode; while ($node !== null) { if ($node instanceof Text) { if ($first === null) { $first = $node; } $last = $node; } else { self::mergeIfNeeded($first, $last); $first = null; $last = null; } if ($node === $toNode) { break; } $node = $node->next(); } self::mergeIfNeeded($first, $last); } private static function mergeIfNeeded(?Text $first, ?Text $last): void { if ($first === null || $last === null || $first === $last) { // No merging needed return; } $s = $first->getLiteral(); $node = $first->next(); $stop = $last->next(); while ($node !== $stop && $node instanceof Text) { $s .= $node->getLiteral(); $unlink = $node; $node = $node->next(); $unlink->detach(); } $first->setLiteral($s); } } PK ! C�N�� � Node/Inline/Newline.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Inline; final class Newline extends AbstractInline { // Any changes to these constants should be reflected in .phpstorm.meta.php public const HARDBREAK = 0; public const SOFTBREAK = 1; /** @psalm-readonly */ private int $type; public function __construct(int $breakType = self::HARDBREAK) { parent::__construct(); $this->type = $breakType; } /** @psalm-immutable */ public function getType(): int { return $this->type; } } PK ! j}RM M Node/Inline/Text.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Inline; final class Text extends AbstractStringContainer { public function append(string $literal): void { $this->literal .= $literal; } } PK ! j� �W W ' Node/Inline/AbstractStringContainer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Inline; use League\CommonMark\Node\StringContainerInterface; abstract class AbstractStringContainer extends AbstractInline implements StringContainerInterface { protected string $literal = ''; /** * @param array<string, mixed> $data */ public function __construct(string $contents = '', array $data = []) { parent::__construct(); $this->literal = $contents; if (\count($data) > 0) { $this->data->import($data); } } public function getLiteral(): string { return $this->literal; } public function setLiteral(string $literal): void { $this->literal = $literal; } } PK ! i�� � " Node/Inline/DelimitedInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Inline; interface DelimitedInterface { public function getOpeningDelimiter(): string; public function getClosingDelimiter(): string; } PK ! ,�� � Node/NodeWalker.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node; use League\CommonMark\Node\Block\AbstractBlock; final class NodeWalker { /** @psalm-readonly */ private Node $root; /** @psalm-readonly-allow-private-mutation */ private ?Node $current = null; /** @psalm-readonly-allow-private-mutation */ private bool $entering; public function __construct(Node $root) { $this->root = $root; $this->current = $this->root; $this->entering = true; } /** * Returns an event which contains node and entering flag * (entering is true when we enter a Node from a parent or sibling, * and false when we reenter it from child) */ public function next(): ?NodeWalkerEvent { $current = $this->current; $entering = $this->entering; if ($current === null) { return null; } if ($entering && ($current instanceof AbstractBlock || $current->hasChildren())) { if ($current->firstChild()) { $this->current = $current->firstChild(); $this->entering = true; } else { $this->entering = false; } } elseif ($current === $this->root) { $this->current = null; } elseif ($current->next() === null) { $this->current = $current->parent(); $this->entering = false; } else { $this->current = $current->next(); $this->entering = true; } return new NodeWalkerEvent($current, $entering); } /** * Resets the iterator to resume at the specified node */ public function resumeAt(Node $node, bool $entering = true): void { $this->current = $node; $this->entering = $entering; } } PK ! K��s} } Node/NodeWalkerEvent.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node; final class NodeWalkerEvent { /** @psalm-readonly */ private Node $node; /** @psalm-readonly */ private bool $isEntering; public function __construct(Node $node, bool $isEntering = true) { $this->node = $node; $this->isEntering = $isEntering; } public function getNode(): Node { return $this->node; } public function isEntering(): bool { return $this->isEntering; } } PK ! � ��� � ! Node/StringContainerInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node; /** * Interface for a node which directly contains line(s) of text */ interface StringContainerInterface { public function setLiteral(string $literal): void; public function getLiteral(): string; } PK ! Ҽƨ Node/Block/Document.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Block; use League\CommonMark\Parser\Cursor; use League\CommonMark\Reference\ReferenceMap; use League\CommonMark\Reference\ReferenceMapInterface; class Document extends AbstractBlock { /** @psalm-readonly */ protected ReferenceMapInterface $referenceMap; public function __construct(?ReferenceMapInterface $referenceMap = null) { parent::__construct(); $this->setStartLine(1); $this->referenceMap = $referenceMap ?? new ReferenceMap(); } public function getReferenceMap(): ReferenceMapInterface { return $this->referenceMap; } public function canContain(AbstractBlock $block): bool { return true; } public function isCode(): bool { return false; } public function matchesNextLine(Cursor $cursor): bool { return true; } } PK ! �w�Q� � " Node/Block/TightBlockInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Block; interface TightBlockInterface { public function isTight(): bool; public function setTight(bool $tight): void; } PK ! ���c3 3 Node/Block/Paragraph.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Block; class Paragraph extends AbstractBlock { /** @internal */ public bool $onlyContainsLinkReferenceDefinitions = false; } PK ! �t� � Node/Block/AbstractBlock.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Node\Block; use League\CommonMark\Exception\InvalidArgumentException; use League\CommonMark\Node\Node; /** * Block-level element * * @method parent() ?AbstractBlock */ abstract class AbstractBlock extends Node { protected ?int $startLine = null; protected ?int $endLine = null; protected function setParent(?Node $node = null): void { if ($node && ! $node instanceof self) { throw new InvalidArgumentException('Parent of block must also be block (cannot be inline)'); } parent::setParent($node); } public function setStartLine(?int $startLine): void { $this->startLine = $startLine; if ($this->endLine === null) { $this->endLine = $startLine; } } public function getStartLine(): ?int { return $this->startLine; } public function setEndLine(?int $endLine): void { $this->endLine = $endLine; } public function getEndLine(): ?int { return $this->endLine; } } PK ! �ֵ�N N MarkdownConverterInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark; use League\CommonMark\Exception\CommonMarkException; use League\CommonMark\Output\RenderedContentInterface; /** * Interface for a service which converts Markdown to HTML. * * @deprecated since 2.2; use {@link ConverterInterface} instead */ interface MarkdownConverterInterface { /** * Converts Markdown to HTML. * * @deprecated since 2.2; use {@link ConverterInterface::convert()} instead * * @throws CommonMarkException */ public function convertToHtml(string $markdown): RenderedContentInterface; } PK ! �t�E� � Normalizer/SlugNormalizer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Normalizer; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; /** * Creates URL-friendly strings based on the given string input */ final class SlugNormalizer implements TextNormalizerInterface, ConfigurationAwareInterface { /** @psalm-allow-private-mutation */ private int $defaultMaxLength = 255; public function setConfiguration(ConfigurationInterface $configuration): void { $this->defaultMaxLength = $configuration->get('slug_normalizer/max_length'); } /** * {@inheritDoc} * * @psalm-immutable */ public function normalize(string $text, array $context = []): string { // Add any requested prefix $slug = ($context['prefix'] ?? '') . $text; // Trim whitespace $slug = \trim($slug); // Convert to lowercase $slug = \mb_strtolower($slug, 'UTF-8'); // Try replacing whitespace with a dash $slug = \preg_replace('/\s+/u', '-', $slug) ?? $slug; // Try removing characters other than letters, numbers, and marks. $slug = \preg_replace('/[^\p{L}\p{Nd}\p{Nl}\p{M}-]+/u', '', $slug) ?? $slug; // Trim to requested length if given if ($length = $context['length'] ?? $this->defaultMaxLength) { $slug = \mb_substr($slug, 0, $length, 'UTF-8'); } return $slug; } } PK ! ��� � # Normalizer/UniqueSlugNormalizer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Normalizer; // phpcs:disable Squiz.Strings.DoubleQuoteUsage.ContainsVar final class UniqueSlugNormalizer implements UniqueSlugNormalizerInterface { private TextNormalizerInterface $innerNormalizer; /** @var array<string, bool> */ private array $alreadyUsed = []; public function __construct(TextNormalizerInterface $innerNormalizer) { $this->innerNormalizer = $innerNormalizer; } public function clearHistory(): void { $this->alreadyUsed = []; } /** * {@inheritDoc} * * @psalm-allow-private-mutation */ public function normalize(string $text, array $context = []): string { $normalized = $this->innerNormalizer->normalize($text, $context); // If it's not unique, add an incremental number to the end until we get a unique version if (\array_key_exists($normalized, $this->alreadyUsed)) { $suffix = 0; do { ++$suffix; } while (\array_key_exists("$normalized-$suffix", $this->alreadyUsed)); $normalized = "$normalized-$suffix"; } $this->alreadyUsed[$normalized] = true; return $normalized; } } PK ! V�|Z� � Normalizer/TextNormalizer.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Normalizer; /*** * Normalize text input using the steps given by the CommonMark spec to normalize labels * * @see https://spec.commonmark.org/0.29/#matches * * @psalm-immutable */ final class TextNormalizer implements TextNormalizerInterface { /** * {@inheritDoc} * * @psalm-pure */ public function normalize(string $text, array $context = []): string { // Collapse internal whitespace to single space and remove // leading/trailing whitespace $text = \preg_replace('/[ \t\r\n]+/', ' ', \trim($text)); \assert(\is_string($text)); return \mb_convert_case($text, \MB_CASE_FOLD, 'UTF-8'); } } PK ! ��R�� � , Normalizer/UniqueSlugNormalizerInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Normalizer; interface UniqueSlugNormalizerInterface extends TextNormalizerInterface { public const DISABLED = false; public const PER_ENVIRONMENT = 'environment'; public const PER_DOCUMENT = 'document'; /** * Called by the Environment whenever the configured scope changes * * Currently, this will only be called PER_DOCUMENT. */ public function clearHistory(): void; } PK ! �U�� & Normalizer/TextNormalizerInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Normalizer; /** * Creates a normalized version of the given input text */ interface TextNormalizerInterface { /** * @param string $text The text to normalize * @param array<string, mixed> $context Additional context about the text being normalized (optional) * * $context may include (but is not required to include) the following: * - `prefix` - A string prefix to prepend to each normalized result * - `length` - The requested maximum length * - `node` - The node we're normalizing text for * * Implementations do not have to use or respect any information within that $context */ public function normalize(string $text, array $context = []): string; } PK ! �� � � CommonMarkConverter.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark; use League\CommonMark\Environment\Environment; use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension; /** * Converts CommonMark-compatible Markdown to HTML. */ final class CommonMarkConverter extends MarkdownConverter { /** * Create a new Markdown converter pre-configured for CommonMark * * @param array<string, mixed> $config */ public function __construct(array $config = []) { $environment = new Environment($config); $environment->addExtension(new CommonMarkCoreExtension()); parent::__construct($environment); } public function getEnvironment(): Environment { \assert($this->environment instanceof Environment); return $this->environment; } } PK ! �?� � Output/RenderedContent.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Output; use League\CommonMark\Node\Block\Document; class RenderedContent implements RenderedContentInterface, \Stringable { /** @psalm-readonly */ private Document $document; /** @psalm-readonly */ private string $content; public function __construct(Document $document, string $content) { $this->document = $document; $this->content = $content; } public function getDocument(): Document { return $this->document; } public function getContent(): string { return $this->content; } /** * @psalm-mutation-free */ public function __toString(): string { return $this->content; } } PK ! ԧ7�L L # Output/RenderedContentInterface.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Output; use League\CommonMark\Node\Block\Document; interface RenderedContentInterface extends \Stringable { /** * @psalm-mutation-free */ public function getDocument(): Document; /** * @psalm-mutation-free */ public function getContent(): string; } PK ! ���%� � ) Environment/EnvironmentAwareInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Environment; interface EnvironmentAwareInterface { public function setEnvironment(EnvironmentInterface $environment): void; } PK ! �R�M�: �: Environment/Environment.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Environment; use League\CommonMark\Delimiter\DelimiterParser; use League\CommonMark\Delimiter\Processor\DelimiterProcessorCollection; use League\CommonMark\Delimiter\Processor\DelimiterProcessorInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Event\ListenerData; use League\CommonMark\Exception\AlreadyInitializedException; use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension; use League\CommonMark\Extension\ConfigurableExtensionInterface; use League\CommonMark\Extension\ExtensionInterface; use League\CommonMark\Extension\GithubFlavoredMarkdownExtension; use League\CommonMark\Normalizer\SlugNormalizer; use League\CommonMark\Normalizer\TextNormalizerInterface; use League\CommonMark\Normalizer\UniqueSlugNormalizer; use League\CommonMark\Normalizer\UniqueSlugNormalizerInterface; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Block\SkipLinesStartingWithLettersParser; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlFilter; use League\CommonMark\Util\PrioritizedList; use League\Config\Configuration; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; use Nette\Schema\Expect; use Psr\EventDispatcher\EventDispatcherInterface; use Psr\EventDispatcher\ListenerProviderInterface; use Psr\EventDispatcher\StoppableEventInterface; final class Environment implements EnvironmentInterface, EnvironmentBuilderInterface, ListenerProviderInterface { /** * @var ExtensionInterface[] * * @psalm-readonly-allow-private-mutation */ private array $extensions = []; /** * @var ExtensionInterface[] * * @psalm-readonly-allow-private-mutation */ private array $uninitializedExtensions = []; /** @psalm-readonly-allow-private-mutation */ private bool $extensionsInitialized = false; /** * @var PrioritizedList<BlockStartParserInterface> * * @psalm-readonly */ private PrioritizedList $blockStartParsers; /** * @var PrioritizedList<InlineParserInterface> * * @psalm-readonly */ private PrioritizedList $inlineParsers; /** @psalm-readonly */ private DelimiterProcessorCollection $delimiterProcessors; /** * @var array<string, PrioritizedList<NodeRendererInterface>> * * @psalm-readonly-allow-private-mutation */ private array $renderersByClass = []; /** * @var PrioritizedList<ListenerData> * * @psalm-readonly-allow-private-mutation */ private PrioritizedList $listenerData; private ?EventDispatcherInterface $eventDispatcher = null; /** @psalm-readonly */ private Configuration $config; private ?TextNormalizerInterface $slugNormalizer = null; /** * @param array<string, mixed> $config */ public function __construct(array $config = []) { $this->config = self::createDefaultConfiguration(); $this->config->merge($config); $this->blockStartParsers = new PrioritizedList(); $this->inlineParsers = new PrioritizedList(); $this->listenerData = new PrioritizedList(); $this->delimiterProcessors = new DelimiterProcessorCollection(); // Performance optimization: always include a block "parser" that aborts parsing if a line starts with a letter // and is therefore unlikely to match any lines as a block start. $this->addBlockStartParser(new SkipLinesStartingWithLettersParser(), 249); } public function getConfiguration(): ConfigurationInterface { return $this->config->reader(); } /** * @deprecated Environment::mergeConfig() is deprecated since league/commonmark v2.0 and will be removed in v3.0. Configuration should be set when instantiating the environment instead. * * @param array<string, mixed> $config */ public function mergeConfig(array $config): void { @\trigger_error('Environment::mergeConfig() is deprecated since league/commonmark v2.0 and will be removed in v3.0. Configuration should be set when instantiating the environment instead.', \E_USER_DEPRECATED); $this->assertUninitialized('Failed to modify configuration.'); $this->config->merge($config); } public function addBlockStartParser(BlockStartParserInterface $parser, int $priority = 0): EnvironmentBuilderInterface { $this->assertUninitialized('Failed to add block start parser.'); $this->blockStartParsers->add($parser, $priority); $this->injectEnvironmentAndConfigurationIfNeeded($parser); return $this; } public function addInlineParser(InlineParserInterface $parser, int $priority = 0): EnvironmentBuilderInterface { $this->assertUninitialized('Failed to add inline parser.'); $this->inlineParsers->add($parser, $priority); $this->injectEnvironmentAndConfigurationIfNeeded($parser); return $this; } public function addDelimiterProcessor(DelimiterProcessorInterface $processor): EnvironmentBuilderInterface { $this->assertUninitialized('Failed to add delimiter processor.'); $this->delimiterProcessors->add($processor); $this->injectEnvironmentAndConfigurationIfNeeded($processor); return $this; } public function addRenderer(string $nodeClass, NodeRendererInterface $renderer, int $priority = 0): EnvironmentBuilderInterface { $this->assertUninitialized('Failed to add renderer.'); if (! isset($this->renderersByClass[$nodeClass])) { $this->renderersByClass[$nodeClass] = new PrioritizedList(); } $this->renderersByClass[$nodeClass]->add($renderer, $priority); $this->injectEnvironmentAndConfigurationIfNeeded($renderer); return $this; } /** * {@inheritDoc} */ public function getBlockStartParsers(): iterable { if (! $this->extensionsInitialized) { $this->initializeExtensions(); } return $this->blockStartParsers->getIterator(); } public function getDelimiterProcessors(): DelimiterProcessorCollection { if (! $this->extensionsInitialized) { $this->initializeExtensions(); } return $this->delimiterProcessors; } /** * {@inheritDoc} */ public function getRenderersForClass(string $nodeClass): iterable { if (! $this->extensionsInitialized) { $this->initializeExtensions(); } // If renderers are defined for this specific class, return them immediately if (isset($this->renderersByClass[$nodeClass])) { return $this->renderersByClass[$nodeClass]; } /** @psalm-suppress TypeDoesNotContainType -- Bug: https://github.com/vimeo/psalm/issues/3332 */ while (\class_exists($parent ??= $nodeClass) && $parent = \get_parent_class($parent)) { if (! isset($this->renderersByClass[$parent])) { continue; } // "Cache" this result to avoid future loops return $this->renderersByClass[$nodeClass] = $this->renderersByClass[$parent]; } return []; } /** * {@inheritDoc} */ public function getExtensions(): iterable { return $this->extensions; } /** * Add a single extension * * @return $this */ public function addExtension(ExtensionInterface $extension): EnvironmentBuilderInterface { $this->assertUninitialized('Failed to add extension.'); $this->extensions[] = $extension; $this->uninitializedExtensions[] = $extension; if ($extension instanceof ConfigurableExtensionInterface) { $extension->configureSchema($this->config); } return $this; } private function initializeExtensions(): void { // Initialize the slug normalizer $this->getSlugNormalizer(); // Ask all extensions to register their components while (\count($this->uninitializedExtensions) > 0) { foreach ($this->uninitializedExtensions as $i => $extension) { $extension->register($this); unset($this->uninitializedExtensions[$i]); } } $this->extensionsInitialized = true; // Create the special delimiter parser if any processors were registered if ($this->delimiterProcessors->count() > 0) { $this->inlineParsers->add(new DelimiterParser($this->delimiterProcessors), PHP_INT_MIN); } } private function injectEnvironmentAndConfigurationIfNeeded(object $object): void { if ($object instanceof EnvironmentAwareInterface) { $object->setEnvironment($this); } if ($object instanceof ConfigurationAwareInterface) { $object->setConfiguration($this->config->reader()); } } /** * @deprecated Instantiate the environment and add the extension yourself * * @param array<string, mixed> $config */ public static function createCommonMarkEnvironment(array $config = []): Environment { $environment = new self($config); $environment->addExtension(new CommonMarkCoreExtension()); return $environment; } /** * @deprecated Instantiate the environment and add the extension yourself * * @param array<string, mixed> $config */ public static function createGFMEnvironment(array $config = []): Environment { $environment = new self($config); $environment->addExtension(new CommonMarkCoreExtension()); $environment->addExtension(new GithubFlavoredMarkdownExtension()); return $environment; } public function addEventListener(string $eventClass, callable $listener, int $priority = 0): EnvironmentBuilderInterface { $this->assertUninitialized('Failed to add event listener.'); $this->listenerData->add(new ListenerData($eventClass, $listener), $priority); if (\is_object($listener)) { $this->injectEnvironmentAndConfigurationIfNeeded($listener); } elseif (\is_array($listener) && \is_object($listener[0])) { $this->injectEnvironmentAndConfigurationIfNeeded($listener[0]); } return $this; } public function dispatch(object $event): object { if (! $this->extensionsInitialized) { $this->initializeExtensions(); } if ($this->eventDispatcher !== null) { return $this->eventDispatcher->dispatch($event); } foreach ($this->getListenersForEvent($event) as $listener) { if ($event instanceof StoppableEventInterface && $event->isPropagationStopped()) { return $event; } $listener($event); } return $event; } public function setEventDispatcher(EventDispatcherInterface $dispatcher): void { $this->eventDispatcher = $dispatcher; } /** * {@inheritDoc} * * @return iterable<callable> */ public function getListenersForEvent(object $event): iterable { foreach ($this->listenerData as $listenerData) { \assert($listenerData instanceof ListenerData); /** @psalm-suppress ArgumentTypeCoercion */ if (! \is_a($event, $listenerData->getEvent())) { continue; } yield function (object $event) use ($listenerData) { if (! $this->extensionsInitialized) { $this->initializeExtensions(); } return \call_user_func($listenerData->getListener(), $event); }; } } /** * @return iterable<InlineParserInterface> */ public function getInlineParsers(): iterable { if (! $this->extensionsInitialized) { $this->initializeExtensions(); } return $this->inlineParsers->getIterator(); } public function getSlugNormalizer(): TextNormalizerInterface { if ($this->slugNormalizer === null) { $normalizer = $this->config->get('slug_normalizer/instance'); \assert($normalizer instanceof TextNormalizerInterface); $this->injectEnvironmentAndConfigurationIfNeeded($normalizer); if ($this->config->get('slug_normalizer/unique') !== UniqueSlugNormalizerInterface::DISABLED && ! $normalizer instanceof UniqueSlugNormalizer) { $normalizer = new UniqueSlugNormalizer($normalizer); } if ($normalizer instanceof UniqueSlugNormalizer) { if ($this->config->get('slug_normalizer/unique') === UniqueSlugNormalizerInterface::PER_DOCUMENT) { $this->addEventListener(DocumentParsedEvent::class, [$normalizer, 'clearHistory'], -1000); } } $this->slugNormalizer = $normalizer; } return $this->slugNormalizer; } /** * @throws AlreadyInitializedException */ private function assertUninitialized(string $message): void { if ($this->extensionsInitialized) { throw new AlreadyInitializedException($message . ' Extensions have already been initialized.'); } } public static function createDefaultConfiguration(): Configuration { return new Configuration([ 'html_input' => Expect::anyOf(HtmlFilter::STRIP, HtmlFilter::ALLOW, HtmlFilter::ESCAPE)->default(HtmlFilter::ALLOW), 'allow_unsafe_links' => Expect::bool(true), 'max_nesting_level' => Expect::type('int')->default(PHP_INT_MAX), 'renderer' => Expect::structure([ 'block_separator' => Expect::string("\n"), 'inner_separator' => Expect::string("\n"), 'soft_break' => Expect::string("\n"), ]), 'slug_normalizer' => Expect::structure([ 'instance' => Expect::type(TextNormalizerInterface::class)->default(new SlugNormalizer()), 'max_length' => Expect::int()->min(0)->default(255), 'unique' => Expect::anyOf(UniqueSlugNormalizerInterface::DISABLED, UniqueSlugNormalizerInterface::PER_ENVIRONMENT, UniqueSlugNormalizerInterface::PER_DOCUMENT)->default(UniqueSlugNormalizerInterface::PER_DOCUMENT), ]), ]); } } PK ! T1�T T $ Environment/EnvironmentInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Environment; use League\CommonMark\Delimiter\Processor\DelimiterProcessorCollection; use League\CommonMark\Extension\ExtensionInterface; use League\CommonMark\Node\Node; use League\CommonMark\Normalizer\TextNormalizerInterface; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\Config\ConfigurationProviderInterface; use Psr\EventDispatcher\EventDispatcherInterface; interface EnvironmentInterface extends ConfigurationProviderInterface, EventDispatcherInterface { /** * Get all registered extensions * * @return ExtensionInterface[] */ public function getExtensions(): iterable; /** * @return iterable<BlockStartParserInterface> */ public function getBlockStartParsers(): iterable; /** * @return iterable<InlineParserInterface> */ public function getInlineParsers(): iterable; public function getDelimiterProcessors(): DelimiterProcessorCollection; /** * @psalm-param class-string<Node> $nodeClass * * @return iterable<NodeRendererInterface> */ public function getRenderersForClass(string $nodeClass): iterable; public function getSlugNormalizer(): TextNormalizerInterface; } PK ! ���b b + Environment/EnvironmentBuilderInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Environment; use League\CommonMark\Delimiter\Processor\DelimiterProcessorInterface; use League\CommonMark\Exception\AlreadyInitializedException; use League\CommonMark\Extension\ExtensionInterface; use League\CommonMark\Node\Node; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\Config\ConfigurationProviderInterface; /** * Interface for building the Environment with any extensions, parsers, listeners, etc. that it may need */ interface EnvironmentBuilderInterface extends ConfigurationProviderInterface { /** * Registers the given extension with the Environment * * @throws AlreadyInitializedException if the Environment has already been initialized */ public function addExtension(ExtensionInterface $extension): EnvironmentBuilderInterface; /** * Registers the given block start parser with the Environment * * @param BlockStartParserInterface $parser Block parser instance * @param int $priority Priority (a higher number will be executed earlier) * * @return $this * * @throws AlreadyInitializedException if the Environment has already been initialized */ public function addBlockStartParser(BlockStartParserInterface $parser, int $priority = 0): EnvironmentBuilderInterface; /** * Registers the given inline parser with the Environment * * @param InlineParserInterface $parser Inline parser instance * @param int $priority Priority (a higher number will be executed earlier) * * @return $this * * @throws AlreadyInitializedException if the Environment has already been initialized */ public function addInlineParser(InlineParserInterface $parser, int $priority = 0): EnvironmentBuilderInterface; /** * Registers the given delimiter processor with the Environment * * @param DelimiterProcessorInterface $processor Delimiter processors instance * * @throws AlreadyInitializedException if the Environment has already been initialized */ public function addDelimiterProcessor(DelimiterProcessorInterface $processor): EnvironmentBuilderInterface; /** * Registers the given node renderer with the Environment * * @param string $nodeClass The fully-qualified node element class name the renderer below should handle * @param NodeRendererInterface $renderer The renderer responsible for rendering the type of element given above * @param int $priority Priority (a higher number will be executed earlier) * * @psalm-param class-string<Node> $nodeClass * * @return $this * * @throws AlreadyInitializedException if the Environment has already been initialized */ public function addRenderer(string $nodeClass, NodeRendererInterface $renderer, int $priority = 0): EnvironmentBuilderInterface; /** * Registers the given event listener * * @param class-string $eventClass Fully-qualified class name of the event this listener should respond to * @param callable $listener Listener to be executed * @param int $priority Priority (a higher number will be executed earlier) * * @return $this * * @throws AlreadyInitializedException if the Environment has already been initialized */ public function addEventListener(string $eventClass, callable $listener, int $priority = 0): EnvironmentBuilderInterface; } PK ! 0�!�� � Event/AbstractEvent.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the Symfony EventDispatcher "Event" contract * - (c) 2018-2019 Fabien Potencier * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Event; use Psr\EventDispatcher\StoppableEventInterface; /** * Base class for classes containing event data. * * This class contains no event data. It is used by events that do not pass * state information to an event handler when an event is raised. * * You can call the method stopPropagation() to abort the execution of * further listeners in your event listener. */ abstract class AbstractEvent implements StoppableEventInterface { /** @psalm-readonly-allow-private-mutation */ private bool $propagationStopped = false; /** * Returns whether further event listeners should be triggered. */ final public function isPropagationStopped(): bool { return $this->propagationStopped; } /** * Stops the propagation of the event to further event listeners. * * If multiple event listeners are connected to the same event, no * further event listener will be triggered once any trigger calls * stopPropagation(). */ final public function stopPropagation(): void { $this->propagationStopped = true; } } PK ! �/E� � Event/ListenerData.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Event; /** * @internal * * @psalm-immutable */ final class ListenerData { /** @var class-string */ private string $event; /** @var callable */ private $listener; /** * @param class-string $event */ public function __construct(string $event, callable $listener) { $this->event = $event; $this->listener = $listener; } /** * @return class-string */ public function getEvent(): string { return $this->event; } public function getListener(): callable { return $this->listener; } } PK ! A2hێ � Event/DocumentPreRenderEvent.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Event; use League\CommonMark\Node\Block\Document; /** * Event dispatched just before rendering begins */ final class DocumentPreRenderEvent extends AbstractEvent { /** @psalm-readonly */ private Document $document; /** @psalm-readonly */ private string $format; public function __construct(Document $document, string $format) { $this->document = $document; $this->format = $format; } public function getDocument(): Document { return $this->document; } public function getFormat(): string { return $this->format; } } PK ! ��t t Event/DocumentPreParsedEvent.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Event; use League\CommonMark\Input\MarkdownInputInterface; use League\CommonMark\Node\Block\Document; /** * Event dispatched when the document is about to be parsed */ final class DocumentPreParsedEvent extends AbstractEvent { /** @psalm-readonly */ private Document $document; private MarkdownInputInterface $markdown; public function __construct(Document $document, MarkdownInputInterface $markdown) { $this->document = $document; $this->markdown = $markdown; } public function getDocument(): Document { return $this->document; } public function getMarkdown(): MarkdownInputInterface { return $this->markdown; } public function replaceMarkdown(MarkdownInputInterface $markdownInput): void { $this->markdown = $markdownInput; } } PK ! �oF/� � Event/DocumentRenderedEvent.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Event; use League\CommonMark\Output\RenderedContentInterface; final class DocumentRenderedEvent extends AbstractEvent { private RenderedContentInterface $output; public function __construct(RenderedContentInterface $output) { $this->output = $output; } /** * @psalm-mutation-free */ public function getOutput(): RenderedContentInterface { return $this->output; } /** * @psalm-external-mutation-free */ public function replaceOutput(RenderedContentInterface $output): void { $this->output = $output; } } PK ! �V2� � Event/DocumentParsedEvent.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Event; use League\CommonMark\Node\Block\Document; /** * Event dispatched when the document has been fully parsed */ final class DocumentParsedEvent extends AbstractEvent { /** @psalm-readonly */ private Document $document; public function __construct(Document $document) { $this->document = $document; } public function getDocument(): Document { return $this->document; } } PK ! #W� Input/MarkdownInputInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Input; interface MarkdownInputInterface { public function getContent(): string; /** * @return iterable<int, string> */ public function getLines(): iterable; public function getLineCount(): int; } PK ! D2Ix Input/MarkdownInput.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Input; use League\CommonMark\Exception\UnexpectedEncodingException; class MarkdownInput implements MarkdownInputInterface { /** * @var array<int, string>|null * * @psalm-readonly-allow-private-mutation */ private ?array $lines = null; /** @psalm-readonly-allow-private-mutation */ private string $content; /** @psalm-readonly-allow-private-mutation */ private ?int $lineCount = null; /** @psalm-readonly */ private int $lineOffset; public function __construct(string $content, int $lineOffset = 0) { if (! \mb_check_encoding($content, 'UTF-8')) { throw new UnexpectedEncodingException('Unexpected encoding - UTF-8 or ASCII was expected'); } // Strip any leading UTF-8 BOM if (\substr($content, 0, 3) === "\xEF\xBB\xBF") { $content = \substr($content, 3); } $this->content = $content; $this->lineOffset = $lineOffset; } public function getContent(): string { return $this->content; } /** * {@inheritDoc} */ public function getLines(): iterable { $this->splitLinesIfNeeded(); \assert($this->lines !== null); /** @psalm-suppress PossiblyNullIterator */ foreach ($this->lines as $i => $line) { yield $this->lineOffset + $i + 1 => $line; } } public function getLineCount(): int { $this->splitLinesIfNeeded(); \assert($this->lineCount !== null); return $this->lineCount; } private function splitLinesIfNeeded(): void { if ($this->lines !== null) { return; } $lines = \preg_split('/\r\n|\n|\r/', $this->content); if ($lines === false) { throw new UnexpectedEncodingException('Failed to split Markdown content by line'); } $this->lines = $lines; // Remove any newline which appears at the very end of the string. // We've already split the document by newlines, so we can simply drop // any empty element which appears on the end. if (\end($this->lines) === '') { \array_pop($this->lines); } $this->lineCount = \count($this->lines); } } PK ! z,�dž � Reference/Reference.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Reference; /** * @psalm-immutable */ final class Reference implements ReferenceInterface { /** @psalm-readonly */ private string $label; /** @psalm-readonly */ private string $destination; /** @psalm-readonly */ private string $title; public function __construct(string $label, string $destination, string $title) { $this->label = $label; $this->destination = $destination; $this->title = $title; } public function getLabel(): string { return $this->label; } public function getDestination(): string { return $this->destination; } public function getTitle(): string { return $this->title; } } PK ! �f�F� � $ Reference/ReferenceableInterface.phpnu ȯ�� <?php /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ declare(strict_types=1); namespace League\CommonMark\Reference; interface ReferenceableInterface { public function getReference(): ReferenceInterface; } PK ! �:< # Reference/ReferenceMapInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Reference; /** * A collection of references * * @phpstan-extends \IteratorAggregate<ReferenceInterface> */ interface ReferenceMapInterface extends \IteratorAggregate, \Countable { public function add(ReferenceInterface $reference): void; public function contains(string $label): bool; public function get(string $label): ?ReferenceInterface; } PK ! ���M M Reference/ReferenceMap.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Reference; use League\CommonMark\Normalizer\TextNormalizer; /** * A collection of references, indexed by label */ final class ReferenceMap implements ReferenceMapInterface { /** @psalm-readonly */ private TextNormalizer $normalizer; /** * @var array<string, ReferenceInterface> * * @psalm-readonly-allow-private-mutation */ private array $references = []; public function __construct() { $this->normalizer = new TextNormalizer(); } public function add(ReferenceInterface $reference): void { // Normalize the key $key = $this->normalizer->normalize($reference->getLabel()); // Store the reference $this->references[$key] = $reference; } public function contains(string $label): bool { $label = $this->normalizer->normalize($label); return isset($this->references[$label]); } public function get(string $label): ?ReferenceInterface { $label = $this->normalizer->normalize($label); return $this->references[$label] ?? null; } /** * @return \Traversable<string, ReferenceInterface> */ public function getIterator(): \Traversable { foreach ($this->references as $normalizedLabel => $reference) { yield $normalizedLabel => $reference; } } public function count(): int { return \count($this->references); } } PK ! �;S$ $ Reference/ReferenceParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Reference; use League\CommonMark\Parser\Cursor; use League\CommonMark\Util\LinkParserHelper; final class ReferenceParser { // Looking for the start of a definition, i.e. `[` private const START_DEFINITION = 0; // Looking for and parsing the label, i.e. `[foo]` within `[foo]` private const LABEL = 1; // Parsing the destination, i.e. `/url` in `[foo]: /url` private const DESTINATION = 2; // Looking for the start of a title, i.e. the first `"` in `[foo]: /url "title"` private const START_TITLE = 3; // Parsing the content of the title, i.e. `title` in `[foo]: /url "title"` private const TITLE = 4; // End state, no matter what kind of lines we add, they won't be references private const PARAGRAPH = 5; /** @psalm-readonly-allow-private-mutation */ private string $paragraph = ''; /** * @var array<int, ReferenceInterface> * * @psalm-readonly-allow-private-mutation */ private array $references = []; /** @psalm-readonly-allow-private-mutation */ private int $state = self::START_DEFINITION; /** @psalm-readonly-allow-private-mutation */ private ?string $label = null; /** @psalm-readonly-allow-private-mutation */ private ?string $destination = null; /** * @var string string * * @psalm-readonly-allow-private-mutation */ private string $title = ''; /** @psalm-readonly-allow-private-mutation */ private ?string $titleDelimiter = null; /** @psalm-readonly-allow-private-mutation */ private bool $referenceValid = false; public function getParagraphContent(): string { return $this->paragraph; } /** * @return ReferenceInterface[] */ public function getReferences(): iterable { $this->finishReference(); return $this->references; } public function hasReferences(): bool { return $this->references !== []; } public function parse(string $line): void { if ($this->paragraph !== '') { $this->paragraph .= "\n"; } $this->paragraph .= $line; $cursor = new Cursor($line); while (! $cursor->isAtEnd()) { $result = false; switch ($this->state) { case self::PARAGRAPH: // We're in a paragraph now. Link reference definitions can only appear at the beginning, so once // we're in a paragraph, there's no going back. return; case self::START_DEFINITION: $result = $this->parseStartDefinition($cursor); break; case self::LABEL: $result = $this->parseLabel($cursor); break; case self::DESTINATION: $result = $this->parseDestination($cursor); break; case self::START_TITLE: $result = $this->parseStartTitle($cursor); break; case self::TITLE: $result = $this->parseTitle($cursor); break; default: // this should never happen break; } if (! $result) { $this->state = self::PARAGRAPH; return; } } } private function parseStartDefinition(Cursor $cursor): bool { $cursor->advanceToNextNonSpaceOrTab(); if ($cursor->isAtEnd() || $cursor->getCurrentCharacter() !== '[') { return false; } $this->state = self::LABEL; $this->label = ''; $cursor->advance(); if ($cursor->isAtEnd()) { $this->label .= "\n"; } return true; } private function parseLabel(Cursor $cursor): bool { $cursor->advanceToNextNonSpaceOrTab(); $partialLabel = LinkParserHelper::parsePartialLinkLabel($cursor); if ($partialLabel === null) { return false; } \assert($this->label !== null); $this->label .= $partialLabel; if ($cursor->isAtEnd()) { // label might continue on next line $this->label .= "\n"; return true; } if ($cursor->getCurrentCharacter() !== ']') { return false; } $cursor->advance(); // end of label if ($cursor->getCurrentCharacter() !== ':') { return false; } $cursor->advance(); // spec: A link label can have at most 999 characters inside the square brackets if (\mb_strlen($this->label, 'UTF-8') > 999) { return false; } // spec: A link label must contain at least one non-whitespace character if (\trim($this->label) === '') { return false; } $cursor->advanceToNextNonSpaceOrTab(); $this->state = self::DESTINATION; return true; } private function parseDestination(Cursor $cursor): bool { $cursor->advanceToNextNonSpaceOrTab(); $destination = LinkParserHelper::parseLinkDestination($cursor); if ($destination === null) { return false; } $this->destination = $destination; $advanced = $cursor->advanceToNextNonSpaceOrTab(); if ($cursor->isAtEnd()) { // Destination was at end of line, so this is a valid reference for sure (and maybe a title). // If not at end of line, wait for title to be valid first. $this->referenceValid = true; $this->paragraph = ''; } elseif ($advanced === 0) { // spec: The title must be separated from the link destination by whitespace return false; } $this->state = self::START_TITLE; return true; } private function parseStartTitle(Cursor $cursor): bool { $cursor->advanceToNextNonSpaceOrTab(); if ($cursor->isAtEnd()) { $this->state = self::START_DEFINITION; return true; } $this->titleDelimiter = null; switch ($c = $cursor->getCurrentCharacter()) { case '"': case "'": $this->titleDelimiter = $c; break; case '(': $this->titleDelimiter = ')'; break; default: // no title delimter found break; } if ($this->titleDelimiter !== null) { $this->state = self::TITLE; $cursor->advance(); if ($cursor->isAtEnd()) { $this->title .= "\n"; } } else { $this->finishReference(); // There might be another reference instead, try that for the same character. $this->state = self::START_DEFINITION; } return true; } private function parseTitle(Cursor $cursor): bool { \assert($this->titleDelimiter !== null); $title = LinkParserHelper::parsePartialLinkTitle($cursor, $this->titleDelimiter); if ($title === null) { // Invalid title, stop return false; } // Did we find the end delimiter? $endDelimiterFound = false; if (\substr($title, -1) === $this->titleDelimiter) { $endDelimiterFound = true; // Chop it off $title = \substr($title, 0, -1); } $this->title .= $title; if (! $endDelimiterFound && $cursor->isAtEnd()) { // Title still going, continue on next line $this->title .= "\n"; return true; } // We either hit the end delimiter or some extra whitespace $cursor->advanceToNextNonSpaceOrTab(); if (! $cursor->isAtEnd()) { // spec: No further non-whitespace characters may occur on the line. return false; } $this->referenceValid = true; $this->finishReference(); $this->paragraph = ''; // See if there's another definition $this->state = self::START_DEFINITION; return true; } private function finishReference(): void { if (! $this->referenceValid) { return; } /** @psalm-suppress PossiblyNullArgument -- these can't possibly be null if we're in this state */ $this->references[] = new Reference($this->label, $this->destination, $this->title); $this->label = null; $this->referenceValid = false; $this->destination = null; $this->title = ''; $this->titleDelimiter = null; } } PK ! �~�Lo o Reference/ReferenceInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Reference; /** * Link reference */ interface ReferenceInterface { public function getLabel(): string; public function getDestination(): string; public function getTitle(): string; } PK ! f*��� � ' Renderer/ChildNodeRendererInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Renderer; use League\CommonMark\Node\Node; /** * Renders multiple nodes by delegating to the individual node renderers and adding spacing where needed */ interface ChildNodeRendererInterface { /** * @param Node[] $nodes */ public function renderNodes(iterable $nodes): string; public function getBlockSeparator(): string; public function getInnerSeparator(): string; } PK ! 5O�V5 5 Renderer/HtmlRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Renderer; use League\CommonMark\Environment\EnvironmentInterface; use League\CommonMark\Event\DocumentPreRenderEvent; use League\CommonMark\Event\DocumentRenderedEvent; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Node\Block\Document; use League\CommonMark\Node\Node; use League\CommonMark\Output\RenderedContent; use League\CommonMark\Output\RenderedContentInterface; final class HtmlRenderer implements DocumentRendererInterface, ChildNodeRendererInterface { /** @psalm-readonly */ private EnvironmentInterface $environment; public function __construct(EnvironmentInterface $environment) { $this->environment = $environment; } public function renderDocument(Document $document): RenderedContentInterface { $this->environment->dispatch(new DocumentPreRenderEvent($document, 'html')); $output = new RenderedContent($document, (string) $this->renderNode($document)); $event = new DocumentRenderedEvent($output); $this->environment->dispatch($event); return $event->getOutput(); } /** * {@inheritDoc} */ public function renderNodes(iterable $nodes): string { $output = ''; $isFirstItem = true; foreach ($nodes as $node) { if (! $isFirstItem && $node instanceof AbstractBlock) { $output .= $this->getBlockSeparator(); } $output .= $this->renderNode($node); $isFirstItem = false; } return $output; } /** * @return \Stringable|string * * @throws NoMatchingRendererException */ private function renderNode(Node $node) { $renderers = $this->environment->getRenderersForClass(\get_class($node)); foreach ($renderers as $renderer) { \assert($renderer instanceof NodeRendererInterface); if (($result = $renderer->render($node, $this)) !== null) { return $result; } } throw new NoMatchingRendererException('Unable to find corresponding renderer for node type ' . \get_class($node)); } public function getBlockSeparator(): string { return $this->environment->getConfiguration()->get('renderer/block_separator'); } public function getInnerSeparator(): string { return $this->environment->getConfiguration()->get('renderer/inner_separator'); } } PK ! �:Qd� � & Renderer/DocumentRendererInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Renderer; use League\CommonMark\Node\Block\Document; use League\CommonMark\Output\RenderedContentInterface; /** * Renders a parsed Document AST */ interface DocumentRendererInterface extends MarkdownRendererInterface { /** * Render the given Document node (and all of its children) */ public function renderDocument(Document $document): RenderedContentInterface; } PK ! �=; ; Renderer/Inline/TextRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Renderer\Inline; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\Xml; use League\CommonMark\Xml\XmlNodeRendererInterface; final class TextRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param Text $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): string { Text::assertInstanceOf($node); return Xml::escape($node->getLiteral()); } public function getXmlTagName(Node $node): string { return 'text'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } } PK ! �w��� � # Renderer/Inline/NewlineRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Renderer\Inline; use League\CommonMark\Node\Inline\Newline; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Xml\XmlNodeRendererInterface; use League\Config\ConfigurationAwareInterface; use League\Config\ConfigurationInterface; final class NewlineRenderer implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface { /** @psalm-readonly-allow-private-mutation */ private ConfigurationInterface $config; public function setConfiguration(ConfigurationInterface $configuration): void { $this->config = $configuration; } /** * @param Newline $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): string { Newline::assertInstanceOf($node); if ($node->getType() === Newline::HARDBREAK) { return "<br />\n"; } return $this->config->get('renderer/soft_break'); } /** * @param Newline $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function getXmlTagName(Node $node): string { Newline::assertInstanceOf($node); return $node->getType() === Newline::SOFTBREAK ? 'softbreak' : 'linebreak'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } } PK ! �@�ɥ � ( Renderer/NoMatchingRendererException.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Renderer; use League\CommonMark\Exception\LogicException; class NoMatchingRendererException extends LogicException { } PK ! �쓲� � Renderer/HtmlDecorator.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Renderer; use League\CommonMark\Node\Node; use League\CommonMark\Util\HtmlElement; final class HtmlDecorator implements NodeRendererInterface { private NodeRendererInterface $inner; private string $tag; /** @var array<string, string|string[]|bool> */ private array $attributes; private bool $selfClosing; /** * @param array<string, string|string[]|bool> $attributes */ public function __construct(NodeRendererInterface $inner, string $tag, array $attributes = [], bool $selfClosing = false) { $this->inner = $inner; $this->tag = $tag; $this->attributes = $attributes; $this->selfClosing = $selfClosing; } /** * {@inheritDoc} */ public function render(Node $node, ChildNodeRendererInterface $childRenderer) { return new HtmlElement($this->tag, $this->attributes, $this->inner->render($node, $childRenderer), $this->selfClosing); } } PK ! ��� � & Renderer/MarkdownRendererInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Renderer; use League\CommonMark\Node\Block\Document; use League\CommonMark\Output\RenderedContentInterface; /** * Renders a parsed Document AST * * @deprecated since 2.3; use {@link DocumentRendererInterface} instead */ interface MarkdownRendererInterface { /** * Render the given Document node (and all of its children) */ public function renderDocument(Document $document): RenderedContentInterface; } PK ! ����� � $ Renderer/Block/ParagraphRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Renderer\Block; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Node\Block\TightBlockInterface; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Util\HtmlElement; use League\CommonMark\Xml\XmlNodeRendererInterface; final class ParagraphRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param Paragraph $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer) { Paragraph::assertInstanceOf($node); if ($this->inTightList($node)) { return $childRenderer->renderNodes($node->children()); } $attrs = $node->data->get('attributes'); return new HtmlElement('p', $attrs, $childRenderer->renderNodes($node->children())); } public function getXmlTagName(Node $node): string { return 'paragraph'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return []; } private function inTightList(Paragraph $node): bool { // Only check up to two (2) levels above this for tightness $i = 2; while (($node = $node->parent()) && $i--) { if ($node instanceof TightBlockInterface) { return $node->isTight(); } } return false; } } PK ! �v�|� � # Renderer/Block/DocumentRenderer.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Renderer\Block; use League\CommonMark\Node\Block\Document; use League\CommonMark\Node\Node; use League\CommonMark\Renderer\ChildNodeRendererInterface; use League\CommonMark\Renderer\NodeRendererInterface; use League\CommonMark\Xml\XmlNodeRendererInterface; final class DocumentRenderer implements NodeRendererInterface, XmlNodeRendererInterface { /** * @param Document $node * * {@inheritDoc} * * @psalm-suppress MoreSpecificImplementedParamType */ public function render(Node $node, ChildNodeRendererInterface $childRenderer): string { Document::assertInstanceOf($node); $wholeDoc = $childRenderer->renderNodes($node->children()); return $wholeDoc === '' ? '' : $wholeDoc . "\n"; } public function getXmlTagName(Node $node): string { return 'document'; } /** * {@inheritDoc} */ public function getXmlAttributes(Node $node): array { return [ 'xmlns' => 'http://commonmark.org/xml/1.0', ]; } } PK ! �{5� � " Renderer/NodeRendererInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Renderer; use League\CommonMark\Exception\InvalidArgumentException; use League\CommonMark\Node\Node; interface NodeRendererInterface { /** * @return \Stringable|string|null * * @throws InvalidArgumentException if the wrong type of Node is provided */ public function render(Node $node, ChildNodeRendererInterface $childRenderer); } PK ! �c4�# # " Parser/MarkdownParserInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser; use League\CommonMark\Exception\CommonMarkException; use League\CommonMark\Node\Block\Document; interface MarkdownParserInterface { /** * @throws CommonMarkException */ public function parse(string $input): Document; } PK ! �G_ Parser/InlineParserEngine.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser; use League\CommonMark\Environment\EnvironmentInterface; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Node\Inline\AdjacentTextMerger; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Parser\Inline\InlineParserInterface; use League\CommonMark\Reference\ReferenceMapInterface; /** * @internal */ final class InlineParserEngine implements InlineParserEngineInterface { /** @psalm-readonly */ private EnvironmentInterface $environment; /** @psalm-readonly */ private ReferenceMapInterface $referenceMap; /** * @var array<int, InlineParserInterface|string|bool> * @psalm-var list<array{0: InlineParserInterface, 1: non-empty-string, 2: bool}> * @phpstan-var array<int, array{0: InlineParserInterface, 1: non-empty-string, 2: bool}> */ private array $parsers = []; public function __construct(EnvironmentInterface $environment, ReferenceMapInterface $referenceMap) { $this->environment = $environment; $this->referenceMap = $referenceMap; foreach ($environment->getInlineParsers() as $parser) { \assert($parser instanceof InlineParserInterface); $regex = $parser->getMatchDefinition()->getRegex(); $this->parsers[] = [$parser, $regex, \strlen($regex) !== \mb_strlen($regex, 'UTF-8')]; } } public function parse(string $contents, AbstractBlock $block): void { $contents = \trim($contents); $cursor = new Cursor($contents); $inlineParserContext = new InlineParserContext($cursor, $block, $this->referenceMap); // Have all parsers look at the line to determine what they might want to parse and what positions they exist at foreach ($this->matchParsers($contents) as $matchPosition => $parsers) { $currentPosition = $cursor->getPosition(); // We've already gone past this point if ($currentPosition > $matchPosition) { continue; } // We've skipped over some uninteresting text that should be added as a plain text node if ($currentPosition < $matchPosition) { $cursor->advanceBy($matchPosition - $currentPosition); $this->addPlainText($cursor->getPreviousText(), $block); } // We're now at a potential start - see which of the current parsers can handle it $parsed = false; foreach ($parsers as [$parser, $matches]) { \assert($parser instanceof InlineParserInterface); if ($parser->parse($inlineParserContext->withMatches($matches))) { // A parser has successfully handled the text at the given position; don't consider any others at this position $parsed = true; break; } } if ($parsed) { continue; } // Despite potentially being interested, nothing actually parsed text here, so add the current character and continue onwards $this->addPlainText((string) $cursor->getCurrentCharacter(), $block); $cursor->advance(); } // Add any remaining text that wasn't parsed if (! $cursor->isAtEnd()) { $this->addPlainText($cursor->getRemainder(), $block); } // Process any delimiters that were found $delimiterStack = $inlineParserContext->getDelimiterStack(); $delimiterStack->processDelimiters(null, $this->environment->getDelimiterProcessors()); $delimiterStack->removeAll(); // Combine adjacent text notes into one AdjacentTextMerger::mergeChildNodes($block); } private function addPlainText(string $text, AbstractBlock $container): void { $lastInline = $container->lastChild(); if ($lastInline instanceof Text && ! $lastInline->data->has('delim')) { $lastInline->append($text); } else { $container->appendChild(new Text($text)); } } /** * Given the current line, ask all the parsers which parts of the text they would be interested in parsing. * * The resulting array provides a list of character positions, which parsers are interested in trying to parse * the text at those points, and (for convenience/optimization) what the matching text happened to be. * * @return array<array<int, InlineParserInterface|string>> * * @psalm-return array<int, list<array{0: InlineParserInterface, 1: non-empty-array<string>}>> * * @phpstan-return array<int, array<int, array{0: InlineParserInterface, 1: non-empty-array<string>}>> */ private function matchParsers(string $contents): array { $contents = \trim($contents); $isMultibyte = ! \mb_check_encoding($contents, 'ASCII'); $ret = []; foreach ($this->parsers as [$parser, $regex, $isRegexMultibyte]) { if ($isMultibyte || $isRegexMultibyte) { $regex .= 'u'; } // See if the parser's InlineParserMatch regex matched against any part of the string if (! \preg_match_all($regex, $contents, $matches, \PREG_OFFSET_CAPTURE | \PREG_SET_ORDER)) { continue; } // For each part that matched... foreach ($matches as $match) { if ($isMultibyte) { // PREG_OFFSET_CAPTURE always returns the byte offset, not the char offset, which is annoying $offset = \mb_strlen(\substr($contents, 0, $match[0][1]), 'UTF-8'); } else { $offset = \intval($match[0][1]); } // Remove the offsets, keeping only the matched text $m = \array_column($match, 0); if ($m === []) { continue; } // Add this match to the list of character positions to stop at $ret[$offset][] = [$parser, $m]; } } // Sort matches by position so we visit them in order \ksort($ret); return $ret; } } PK ! W�)�h h Parser/CursorState.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser; /** * Encapsulates the current state of a cursor in case you need to rollback later. * * WARNING: Do not attempt to use this class for ANYTHING except for * type hinting and passing this object back into restoreState(). * The constructor, methods, and inner contents may change in any * future release without warning! * * @internal * * @psalm-immutable */ final class CursorState { /** * @var array<int, mixed> * * @psalm-readonly */ private array $state; /** * @internal * * @param array<int, mixed> $state */ public function __construct(array $state) { $this->state = $state; } /** * @internal * * @return array<int, mixed> */ public function toArray(): array { return $this->state; } } PK ! I7MD6 6 Parser/InlineParserContext.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser; use League\CommonMark\Delimiter\DelimiterStack; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Reference\ReferenceMapInterface; final class InlineParserContext { /** @psalm-readonly */ private AbstractBlock $container; /** @psalm-readonly */ private ReferenceMapInterface $referenceMap; /** @psalm-readonly */ private Cursor $cursor; /** @psalm-readonly */ private DelimiterStack $delimiterStack; /** * @var string[] * @psalm-var non-empty-array<string> * * @psalm-readonly-allow-private-mutation */ private array $matches; public function __construct(Cursor $contents, AbstractBlock $container, ReferenceMapInterface $referenceMap) { $this->referenceMap = $referenceMap; $this->container = $container; $this->cursor = $contents; $this->delimiterStack = new DelimiterStack(); } public function getContainer(): AbstractBlock { return $this->container; } public function getReferenceMap(): ReferenceMapInterface { return $this->referenceMap; } public function getCursor(): Cursor { return $this->cursor; } public function getDelimiterStack(): DelimiterStack { return $this->delimiterStack; } /** * @return string The full text that matched the InlineParserMatch definition */ public function getFullMatch(): string { return $this->matches[0]; } /** * @return int The length of the full match (in characters, not bytes) */ public function getFullMatchLength(): int { return \mb_strlen($this->matches[0], 'UTF-8'); } /** * @return string[] Similar to preg_match(), index 0 will contain the full match, and any other array elements will be captured sub-matches * * @psalm-return non-empty-array<string> */ public function getMatches(): array { return $this->matches; } /** * @return string[] */ public function getSubMatches(): array { return \array_slice($this->matches, 1); } /** * @param string[] $matches * * @psalm-param non-empty-array<string> $matches */ public function withMatches(array $matches): InlineParserContext { $ctx = clone $this; $ctx->matches = $matches; return $ctx; } } PK ! �p�7� � Parser/ParserLogicException.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser; use League\CommonMark\Exception\CommonMarkException; class ParserLogicException extends \LogicException implements CommonMarkException { } PK ! �P�K�0 �0 Parser/MarkdownParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * Additional code based on commonmark-java (https://github.com/commonmark/commonmark-java) * - (c) Atlassian Pty Ltd * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser; use League\CommonMark\Environment\EnvironmentInterface; use League\CommonMark\Event\DocumentParsedEvent; use League\CommonMark\Event\DocumentPreParsedEvent; use League\CommonMark\Exception\CommonMarkException; use League\CommonMark\Input\MarkdownInput; use League\CommonMark\Node\Block\Document; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Block\BlockContinueParserWithInlinesInterface; use League\CommonMark\Parser\Block\BlockStart; use League\CommonMark\Parser\Block\BlockStartParserInterface; use League\CommonMark\Parser\Block\DocumentBlockParser; use League\CommonMark\Parser\Block\ParagraphParser; use League\CommonMark\Reference\ReferenceInterface; use League\CommonMark\Reference\ReferenceMap; final class MarkdownParser implements MarkdownParserInterface { /** @psalm-readonly */ private EnvironmentInterface $environment; /** @psalm-readonly-allow-private-mutation */ private int $maxNestingLevel; /** @psalm-readonly-allow-private-mutation */ private ReferenceMap $referenceMap; /** @psalm-readonly-allow-private-mutation */ private int $lineNumber = 0; /** @psalm-readonly-allow-private-mutation */ private Cursor $cursor; /** * @var array<int, BlockContinueParserInterface> * * @psalm-readonly-allow-private-mutation */ private array $activeBlockParsers = []; /** * @var array<int, BlockContinueParserWithInlinesInterface> * * @psalm-readonly-allow-private-mutation */ private array $closedBlockParsers = []; public function __construct(EnvironmentInterface $environment) { $this->environment = $environment; } private function initialize(): void { $this->referenceMap = new ReferenceMap(); $this->lineNumber = 0; $this->activeBlockParsers = []; $this->closedBlockParsers = []; $this->maxNestingLevel = $this->environment->getConfiguration()->get('max_nesting_level'); } /** * @throws CommonMarkException */ public function parse(string $input): Document { $this->initialize(); $documentParser = new DocumentBlockParser($this->referenceMap); $this->activateBlockParser($documentParser); $preParsedEvent = new DocumentPreParsedEvent($documentParser->getBlock(), new MarkdownInput($input)); $this->environment->dispatch($preParsedEvent); $markdownInput = $preParsedEvent->getMarkdown(); foreach ($markdownInput->getLines() as $lineNumber => $line) { $this->lineNumber = $lineNumber; $this->parseLine($line); } // finalizeAndProcess $this->closeBlockParsers(\count($this->activeBlockParsers), $this->lineNumber); $this->processInlines(); $this->environment->dispatch(new DocumentParsedEvent($documentParser->getBlock())); return $documentParser->getBlock(); } /** * Analyze a line of text and update the document appropriately. We parse markdown text by calling this on each * line of input, then finalizing the document. */ private function parseLine(string $line): void { $this->cursor = new Cursor($line); $matches = $this->parseBlockContinuation(); if ($matches === null) { return; } $unmatchedBlocks = \count($this->activeBlockParsers) - $matches; $blockParser = $this->activeBlockParsers[$matches - 1]; $startedNewBlock = false; // Unless last matched container is a code block, try new container starts, // adding children to the last matched container: $tryBlockStarts = $blockParser->getBlock() instanceof Paragraph || $blockParser->isContainer(); while ($tryBlockStarts) { // this is a little performance optimization if ($this->cursor->isBlank()) { $this->cursor->advanceToEnd(); break; } if ($blockParser->getBlock()->getDepth() >= $this->maxNestingLevel) { break; } $blockStart = $this->findBlockStart($blockParser); if ($blockStart === null || $blockStart->isAborting()) { $this->cursor->advanceToNextNonSpaceOrTab(); break; } if (($state = $blockStart->getCursorState()) !== null) { $this->cursor->restoreState($state); } $startedNewBlock = true; // We're starting a new block. If we have any previous blocks that need to be closed, we need to do it now. if ($unmatchedBlocks > 0) { $this->closeBlockParsers($unmatchedBlocks, $this->lineNumber - 1); $unmatchedBlocks = 0; } $oldBlockLineStart = null; if ($blockStart->isReplaceActiveBlockParser()) { $oldBlockLineStart = $this->prepareActiveBlockParserForReplacement(); } foreach ($blockStart->getBlockParsers() as $newBlockParser) { $blockParser = $this->addChild($newBlockParser, $oldBlockLineStart); $tryBlockStarts = $newBlockParser->isContainer(); } } // What remains at the offset is a text line. Add the text to the appropriate block. // First check for a lazy paragraph continuation: if (! $startedNewBlock && ! $this->cursor->isBlank() && $this->getActiveBlockParser()->canHaveLazyContinuationLines()) { $this->getActiveBlockParser()->addLine($this->cursor->getRemainder()); } else { // finalize any blocks not matched if ($unmatchedBlocks > 0) { $this->closeBlockParsers($unmatchedBlocks, $this->lineNumber - 1); } if (! $blockParser->isContainer()) { $this->getActiveBlockParser()->addLine($this->cursor->getRemainder()); } elseif (! $this->cursor->isBlank()) { $this->addChild(new ParagraphParser()); $this->getActiveBlockParser()->addLine($this->cursor->getRemainder()); } } } private function parseBlockContinuation(): ?int { // For each containing block, try to parse the associated line start. // The document will always match, so we can skip the first block parser and start at 1 matches $matches = 1; for ($i = 1; $i < \count($this->activeBlockParsers); $i++) { $blockParser = $this->activeBlockParsers[$i]; $blockContinue = $blockParser->tryContinue(clone $this->cursor, $this->getActiveBlockParser()); if ($blockContinue === null) { break; } if ($blockContinue->isFinalize()) { $this->closeBlockParsers(\count($this->activeBlockParsers) - $i, $this->lineNumber); return null; } if (($state = $blockContinue->getCursorState()) !== null) { $this->cursor->restoreState($state); } $matches++; } return $matches; } private function findBlockStart(BlockContinueParserInterface $lastMatchedBlockParser): ?BlockStart { $matchedBlockParser = new MarkdownParserState($this->getActiveBlockParser(), $lastMatchedBlockParser); foreach ($this->environment->getBlockStartParsers() as $blockStartParser) { \assert($blockStartParser instanceof BlockStartParserInterface); if (($result = $blockStartParser->tryStart(clone $this->cursor, $matchedBlockParser)) !== null) { return $result; } } return null; } private function closeBlockParsers(int $count, int $endLineNumber): void { for ($i = 0; $i < $count; $i++) { $blockParser = $this->deactivateBlockParser(); $this->finalize($blockParser, $endLineNumber); // phpcs:disable SlevomatCodingStandard.ControlStructures.EarlyExit.EarlyExitNotUsed if ($blockParser instanceof BlockContinueParserWithInlinesInterface) { // Remember for inline parsing $this->closedBlockParsers[] = $blockParser; } } } /** * Finalize a block. Close it and do any necessary postprocessing, e.g. creating string_content from strings, * setting the 'tight' or 'loose' status of a list, and parsing the beginnings of paragraphs for reference * definitions. */ private function finalize(BlockContinueParserInterface $blockParser, int $endLineNumber): void { if ($blockParser instanceof ParagraphParser) { $this->updateReferenceMap($blockParser->getReferences()); } $blockParser->getBlock()->setEndLine($endLineNumber); $blockParser->closeBlock(); } /** * Walk through a block & children recursively, parsing string content into inline content where appropriate. */ private function processInlines(): void { $p = new InlineParserEngine($this->environment, $this->referenceMap); foreach ($this->closedBlockParsers as $blockParser) { $blockParser->parseInlines($p); } } /** * Add block of type tag as a child of the tip. If the tip can't accept children, close and finalize it and try * its parent, and so on til we find a block that can accept children. */ private function addChild(BlockContinueParserInterface $blockParser, ?int $startLineNumber = null): BlockContinueParserInterface { $blockParser->getBlock()->setStartLine($startLineNumber ?? $this->lineNumber); while (! $this->getActiveBlockParser()->canContain($blockParser->getBlock())) { $this->closeBlockParsers(1, ($startLineNumber ?? $this->lineNumber) - 1); } $this->getActiveBlockParser()->getBlock()->appendChild($blockParser->getBlock()); $this->activateBlockParser($blockParser); return $blockParser; } private function activateBlockParser(BlockContinueParserInterface $blockParser): void { $this->activeBlockParsers[] = $blockParser; } /** * @throws ParserLogicException */ private function deactivateBlockParser(): BlockContinueParserInterface { $popped = \array_pop($this->activeBlockParsers); if ($popped === null) { throw new ParserLogicException('The last block parser should not be deactivated'); } return $popped; } /** * @return int|null The line number where the old block started */ private function prepareActiveBlockParserForReplacement(): ?int { // Note that we don't want to parse inlines or finalize this block, as it's getting replaced. $old = $this->deactivateBlockParser(); if ($old instanceof ParagraphParser) { $this->updateReferenceMap($old->getReferences()); } $old->getBlock()->detach(); return $old->getBlock()->getStartLine(); } /** * @param ReferenceInterface[] $references */ private function updateReferenceMap(iterable $references): void { foreach ($references as $reference) { if (! $this->referenceMap->contains($reference->getLabel())) { $this->referenceMap->add($reference); } } } /** * @throws ParserLogicException */ public function getActiveBlockParser(): BlockContinueParserInterface { $active = \end($this->activeBlockParsers); if ($active === false) { throw new ParserLogicException('No active block parsers are available'); } return $active; } } PK ! }jһ� � # Parser/Inline/InlineParserMatch.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Inline; use League\CommonMark\Exception\InvalidArgumentException; final class InlineParserMatch { private string $regex; private bool $caseSensitive; private function __construct(string $regex, bool $caseSensitive = false) { $this->regex = $regex; $this->caseSensitive = $caseSensitive; } public function caseSensitive(): self { $this->caseSensitive = true; return $this; } /** * @internal * * @psalm-return non-empty-string */ public function getRegex(): string { return '/' . $this->regex . '/' . ($this->caseSensitive ? '' : 'i'); } /** * Match the given string (case-insensitive) */ public static function string(string $str): self { return new self(\preg_quote($str, '/')); } /** * Match any of the given strings (case-insensitive) */ public static function oneOf(string ...$str): self { return new self(\implode('|', \array_map(static fn (string $str): string => \preg_quote($str, '/'), $str))); } /** * Match a partial regular expression without starting/ending delimiters, anchors, or flags */ public static function regex(string $regex): self { return new self($regex); } public static function join(self ...$definitions): self { $regex = ''; $caseSensitive = null; foreach ($definitions as $definition) { $regex .= '(' . $definition->regex . ')'; if ($caseSensitive === null) { $caseSensitive = $definition->caseSensitive; } elseif ($caseSensitive !== $definition->caseSensitive) { throw new InvalidArgumentException('Case-sensitive and case-insensitive definitions cannot be combined'); } } return new self($regex, $caseSensitive ?? false); } } PK ! �iK� ' Parser/Inline/InlineParserInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Inline; use League\CommonMark\Parser\InlineParserContext; interface InlineParserInterface { public function getMatchDefinition(): InlineParserMatch; public function parse(InlineParserContext $inlineContext): bool; } PK ! ���, , Parser/Inline/NewlineParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Inline; use League\CommonMark\Node\Inline\Newline; use League\CommonMark\Node\Inline\Text; use League\CommonMark\Parser\InlineParserContext; final class NewlineParser implements InlineParserInterface { public function getMatchDefinition(): InlineParserMatch { return InlineParserMatch::regex('\\n'); } public function parse(InlineParserContext $inlineContext): bool { $inlineContext->getCursor()->advanceBy(1); // Check previous inline for trailing spaces $spaces = 0; $lastInline = $inlineContext->getContainer()->lastChild(); if ($lastInline instanceof Text) { $trimmed = \rtrim($lastInline->getLiteral(), ' '); $spaces = \strlen($lastInline->getLiteral()) - \strlen($trimmed); if ($spaces) { $lastInline->setLiteral($trimmed); } } if ($spaces >= 2) { $inlineContext->getContainer()->appendChild(new Newline(Newline::HARDBREAK)); } else { $inlineContext->getContainer()->appendChild(new Newline(Newline::SOFTBREAK)); } return true; } } PK ! �1a4 4 ' Parser/MarkdownParserStateInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser; use League\CommonMark\Parser\Block\BlockContinueParserInterface; interface MarkdownParserStateInterface { /** * Returns the deepest open block parser */ public function getActiveBlockParser(): BlockContinueParserInterface; /** * Open block parser that was last matched during the continue phase. This is different from the currently active * block parser, as an unmatched block is only closed when a new block is started. */ public function getLastMatchedBlockParser(): BlockContinueParserInterface; /** * Returns the current content of the paragraph if the matched block is a paragraph. The content can be multiple * lines separated by newlines. */ public function getParagraphContent(): ?string; } PK ! ��O8�7 �7 Parser/Cursor.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser; use League\CommonMark\Exception\UnexpectedEncodingException; class Cursor { public const INDENT_LEVEL = 4; /** @psalm-readonly */ private string $line; /** @psalm-readonly */ private int $length; /** * @var int * * It's possible for this to be 1 char past the end, meaning we've parsed all chars and have * reached the end. In this state, any character-returning method MUST return null. */ private int $currentPosition = 0; private int $column = 0; private int $indent = 0; private int $previousPosition = 0; private ?int $nextNonSpaceCache = null; private bool $partiallyConsumedTab = false; /** * @var int|false * * @psalm-readonly */ private $lastTabPosition; /** @psalm-readonly */ private bool $isMultibyte; /** @var array<int, string> */ private array $charCache = []; /** * @param string $line The line being parsed (ASCII or UTF-8) */ public function __construct(string $line) { if (! \mb_check_encoding($line, 'UTF-8')) { throw new UnexpectedEncodingException('Unexpected encoding - UTF-8 or ASCII was expected'); } $this->line = $line; $this->length = \mb_strlen($line, 'UTF-8') ?: 0; $this->isMultibyte = $this->length !== \strlen($line); $this->lastTabPosition = $this->isMultibyte ? \mb_strrpos($line, "\t", 0, 'UTF-8') : \strrpos($line, "\t"); } /** * Returns the position of the next character which is not a space (or tab) */ public function getNextNonSpacePosition(): int { if ($this->nextNonSpaceCache !== null) { return $this->nextNonSpaceCache; } if ($this->currentPosition >= $this->length) { return $this->length; } $cols = $this->column; for ($i = $this->currentPosition; $i < $this->length; $i++) { // This if-else was copied out of getCharacter() for performance reasons if ($this->isMultibyte) { $c = $this->charCache[$i] ??= \mb_substr($this->line, $i, 1, 'UTF-8'); } else { $c = $this->line[$i]; } if ($c === ' ') { $cols++; } elseif ($c === "\t") { $cols += 4 - ($cols % 4); } else { break; } } $this->indent = $cols - $this->column; return $this->nextNonSpaceCache = $i; } /** * Returns the next character which isn't a space (or tab) */ public function getNextNonSpaceCharacter(): ?string { $index = $this->getNextNonSpacePosition(); if ($index >= $this->length) { return null; } if ($this->isMultibyte) { return $this->charCache[$index] ??= \mb_substr($this->line, $index, 1, 'UTF-8'); } return $this->line[$index]; } /** * Calculates the current indent (number of spaces after current position) */ public function getIndent(): int { if ($this->nextNonSpaceCache === null) { $this->getNextNonSpacePosition(); } return $this->indent; } /** * Whether the cursor is indented to INDENT_LEVEL */ public function isIndented(): bool { if ($this->nextNonSpaceCache === null) { $this->getNextNonSpacePosition(); } return $this->indent >= self::INDENT_LEVEL; } public function getCharacter(?int $index = null): ?string { if ($index === null) { $index = $this->currentPosition; } // Index out-of-bounds, or we're at the end if ($index < 0 || $index >= $this->length) { return null; } if ($this->isMultibyte) { return $this->charCache[$index] ??= \mb_substr($this->line, $index, 1, 'UTF-8'); } return $this->line[$index]; } /** * Slightly-optimized version of getCurrent(null) */ public function getCurrentCharacter(): ?string { if ($this->currentPosition >= $this->length) { return null; } if ($this->isMultibyte) { return $this->charCache[$this->currentPosition] ??= \mb_substr($this->line, $this->currentPosition, 1, 'UTF-8'); } return $this->line[$this->currentPosition]; } /** * Returns the next character (or null, if none) without advancing forwards */ public function peek(int $offset = 1): ?string { return $this->getCharacter($this->currentPosition + $offset); } /** * Whether the remainder is blank */ public function isBlank(): bool { return $this->nextNonSpaceCache === $this->length || $this->getNextNonSpacePosition() === $this->length; } /** * Move the cursor forwards */ public function advance(): void { $this->advanceBy(1); } /** * Move the cursor forwards * * @param int $characters Number of characters to advance by * @param bool $advanceByColumns Whether to advance by columns instead of spaces */ public function advanceBy(int $characters, bool $advanceByColumns = false): void { $this->previousPosition = $this->currentPosition; $this->nextNonSpaceCache = null; if ($this->currentPosition >= $this->length || $characters === 0) { return; } // Optimization to avoid tab handling logic if we have no tabs if ($this->lastTabPosition === false || $this->currentPosition > $this->lastTabPosition) { $length = \min($characters, $this->length - $this->currentPosition); $this->partiallyConsumedTab = false; $this->currentPosition += $length; $this->column += $length; return; } $nextFewChars = $this->isMultibyte ? \mb_substr($this->line, $this->currentPosition, $characters, 'UTF-8') : \substr($this->line, $this->currentPosition, $characters); if ($characters === 1) { $asArray = [$nextFewChars]; } elseif ($this->isMultibyte) { /** @var string[] $asArray */ $asArray = \mb_str_split($nextFewChars, 1, 'UTF-8'); } else { $asArray = \str_split($nextFewChars); } foreach ($asArray as $c) { if ($c === "\t") { $charsToTab = 4 - ($this->column % 4); if ($advanceByColumns) { $this->partiallyConsumedTab = $charsToTab > $characters; $charsToAdvance = $charsToTab > $characters ? $characters : $charsToTab; $this->column += $charsToAdvance; $this->currentPosition += $this->partiallyConsumedTab ? 0 : 1; $characters -= $charsToAdvance; } else { $this->partiallyConsumedTab = false; $this->column += $charsToTab; $this->currentPosition++; $characters--; } } else { $this->partiallyConsumedTab = false; $this->currentPosition++; $this->column++; $characters--; } if ($characters <= 0) { break; } } } /** * Advances the cursor by a single space or tab, if present */ public function advanceBySpaceOrTab(): bool { $character = $this->getCurrentCharacter(); if ($character === ' ' || $character === "\t") { $this->advanceBy(1, true); return true; } return false; } /** * Parse zero or more space/tab characters * * @return int Number of positions moved */ public function advanceToNextNonSpaceOrTab(): int { $newPosition = $this->nextNonSpaceCache ?? $this->getNextNonSpacePosition(); if ($newPosition === $this->currentPosition) { return 0; } $this->advanceBy($newPosition - $this->currentPosition); $this->partiallyConsumedTab = false; // We've just advanced to where that non-space is, // so any subsequent calls to find the next one will // always return the current position. $this->nextNonSpaceCache = $this->currentPosition; $this->indent = 0; return $this->currentPosition - $this->previousPosition; } /** * Parse zero or more space characters, including at most one newline. * * Tab characters are not parsed with this function. * * @return int Number of positions moved */ public function advanceToNextNonSpaceOrNewline(): int { $remainder = $this->getRemainder(); // Optimization: Avoid the regex if we know there are no spaces or newlines if ($remainder === '' || ($remainder[0] !== ' ' && $remainder[0] !== "\n")) { $this->previousPosition = $this->currentPosition; return 0; } $matches = []; \preg_match('/^ *(?:\n *)?/', $remainder, $matches, \PREG_OFFSET_CAPTURE); // [0][0] contains the matched text // [0][1] contains the index of that match $increment = $matches[0][1] + \strlen($matches[0][0]); $this->advanceBy($increment); return $this->currentPosition - $this->previousPosition; } /** * Move the position to the very end of the line * * @return int The number of characters moved */ public function advanceToEnd(): int { $this->previousPosition = $this->currentPosition; $this->nextNonSpaceCache = null; $this->currentPosition = $this->length; return $this->currentPosition - $this->previousPosition; } public function getRemainder(): string { if ($this->currentPosition >= $this->length) { return ''; } $prefix = ''; $position = $this->currentPosition; if ($this->partiallyConsumedTab) { $position++; $charsToTab = 4 - ($this->column % 4); $prefix = \str_repeat(' ', $charsToTab); } $subString = $this->isMultibyte ? \mb_substr($this->line, $position, null, 'UTF-8') : \substr($this->line, $position); return $prefix . $subString; } public function getLine(): string { return $this->line; } public function isAtEnd(): bool { return $this->currentPosition >= $this->length; } /** * Try to match a regular expression * * Returns the matching text and advances to the end of that match * * @psalm-param non-empty-string $regex */ public function match(string $regex): ?string { $subject = $this->getRemainder(); if (! \preg_match($regex, $subject, $matches, \PREG_OFFSET_CAPTURE)) { return null; } // $matches[0][0] contains the matched text // $matches[0][1] contains the index of that match if ($this->isMultibyte) { // PREG_OFFSET_CAPTURE always returns the byte offset, not the char offset, which is annoying $offset = \mb_strlen(\substr($subject, 0, $matches[0][1]), 'UTF-8'); $matchLength = \mb_strlen($matches[0][0], 'UTF-8'); } else { $offset = $matches[0][1]; $matchLength = \strlen($matches[0][0]); } // [0][0] contains the matched text // [0][1] contains the index of that match $this->advanceBy($offset + $matchLength); return $matches[0][0]; } /** * Encapsulates the current state of this cursor in case you need to rollback later. * * WARNING: Do not parse or use the return value for ANYTHING except for * passing it back into restoreState(), as the number of values and their * contents may change in any future release without warning. */ public function saveState(): CursorState { return new CursorState([ $this->currentPosition, $this->previousPosition, $this->nextNonSpaceCache, $this->indent, $this->column, $this->partiallyConsumedTab, ]); } /** * Restore the cursor to a previous state. * * Pass in the value previously obtained by calling saveState(). */ public function restoreState(CursorState $state): void { [ $this->currentPosition, $this->previousPosition, $this->nextNonSpaceCache, $this->indent, $this->column, $this->partiallyConsumedTab, ] = $state->toArray(); } public function getPosition(): int { return $this->currentPosition; } public function getPreviousText(): string { if ($this->isMultibyte) { return \mb_substr($this->line, $this->previousPosition, $this->currentPosition - $this->previousPosition, 'UTF-8'); } return \substr($this->line, $this->previousPosition, $this->currentPosition - $this->previousPosition); } public function getSubstring(int $start, ?int $length = null): string { if ($this->isMultibyte) { return \mb_substr($this->line, $start, $length, 'UTF-8'); } if ($length !== null) { return \substr($this->line, $start, $length); } return \substr($this->line, $start); } public function getColumn(): int { return $this->column; } } PK ! B/�< Parser/Block/BlockContinue.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Block; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\CursorState; /** * Result object for continuing parsing of a block; see static methods for constructors. * * @psalm-immutable */ final class BlockContinue { /** @psalm-readonly */ private ?CursorState $cursorState = null; /** @psalm-readonly */ private bool $finalize; private function __construct(?CursorState $cursorState = null, bool $finalize = false) { $this->cursorState = $cursorState; $this->finalize = $finalize; } public function getCursorState(): ?CursorState { return $this->cursorState; } public function isFinalize(): bool { return $this->finalize; } /** * Signal that we cannot continue here * * @return null */ public static function none(): ?self { return null; } /** * Signal that we're continuing at the given position */ public static function at(Cursor $cursor): self { return new self($cursor->saveState(), false); } /** * Signal that we want to finalize and close the block */ public static function finished(): self { return new self(null, true); } } PK ! �w��1 1 * Parser/Block/BlockStartParserInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Block; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; /** * Interface for a block parser which identifies block starts. */ interface BlockStartParserInterface { /** * Check whether we should handle the block at the current position * * @param Cursor $cursor A cloned copy of the cursor at the current parsing location * @param MarkdownParserStateInterface $parserState Additional information about the state of the Markdown parser * * @return BlockStart|null The BlockStart that has been identified, or null if the block doesn't match here */ public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart; } PK ! ��X� � 3 Parser/Block/SkipLinesStartingWithLettersParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Block; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\MarkdownParserStateInterface; use League\CommonMark\Util\RegexHelper; /** * @internal * * This "parser" is actually a performance optimization. * * Most lines in a typical Markdown document probably won't match a block start. This is especially true for lines starting * with letters - nothing in the core CommonMark spec or our supported extensions will match those lines as blocks. Therefore, * if we can identify those lines and skip block start parsing, we can optimize performance by ~10%. * * Previously this optimization was hard-coded in the MarkdownParser but did not allow users to override this behavior. * By implementing this optimization as a block parser instead, users wanting custom blocks starting with letters * can instead register their block parser with a higher priority to ensure their parser is always called first. */ final class SkipLinesStartingWithLettersParser implements BlockStartParserInterface { public function tryStart(Cursor $cursor, MarkdownParserStateInterface $parserState): ?BlockStart { if (! $cursor->isIndented() && RegexHelper::isLetter($cursor->getNextNonSpaceCharacter())) { $cursor->advanceToNextNonSpaceOrTab(); return BlockStart::abort(); } return BlockStart::none(); } } PK ! &�rn� � Parser/Block/ParagraphParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Block; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\InlineParserEngineInterface; use League\CommonMark\Reference\ReferenceInterface; use League\CommonMark\Reference\ReferenceParser; final class ParagraphParser extends AbstractBlockContinueParser implements BlockContinueParserWithInlinesInterface { /** @psalm-readonly */ private Paragraph $block; /** @psalm-readonly */ private ReferenceParser $referenceParser; public function __construct() { $this->block = new Paragraph(); $this->referenceParser = new ReferenceParser(); } public function canHaveLazyContinuationLines(): bool { return true; } public function getBlock(): Paragraph { return $this->block; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { if ($cursor->isBlank()) { return BlockContinue::none(); } return BlockContinue::at($cursor); } public function addLine(string $line): void { $this->referenceParser->parse($line); } public function closeBlock(): void { $this->block->onlyContainsLinkReferenceDefinitions = $this->referenceParser->hasReferences() && $this->referenceParser->getParagraphContent() === ''; } public function parseInlines(InlineParserEngineInterface $inlineParser): void { $content = $this->getContentString(); if ($content !== '') { $inlineParser->parse($content, $this->block); } } public function getContentString(): string { return $this->referenceParser->getParagraphContent(); } /** * @return ReferenceInterface[] */ public function getReferences(): iterable { return $this->referenceParser->getReferences(); } } PK ! ��֧� � Parser/Block/BlockStart.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Block; use League\CommonMark\Parser\Cursor; use League\CommonMark\Parser\CursorState; /** * Result object for starting parsing of a block; see static methods for constructors */ final class BlockStart { /** * @var BlockContinueParserInterface[] * * @psalm-readonly */ private array $blockParsers; /** @psalm-readonly-allow-private-mutation */ private ?CursorState $cursorState = null; /** @psalm-readonly-allow-private-mutation */ private bool $replaceActiveBlockParser = false; private bool $isAborting = false; private function __construct(BlockContinueParserInterface ...$blockParsers) { $this->blockParsers = $blockParsers; } /** * @return BlockContinueParserInterface[] */ public function getBlockParsers(): iterable { return $this->blockParsers; } public function getCursorState(): ?CursorState { return $this->cursorState; } public function isReplaceActiveBlockParser(): bool { return $this->replaceActiveBlockParser; } /** * @internal */ public function isAborting(): bool { return $this->isAborting; } /** * Signal that we want to parse at the given cursor position * * @return $this */ public function at(Cursor $cursor): self { $this->cursorState = $cursor->saveState(); return $this; } /** * Signal that we want to replace the active block parser with this one * * @return $this */ public function replaceActiveBlockParser(): self { $this->replaceActiveBlockParser = true; return $this; } /** * Signal that we cannot parse whatever is here * * @return null */ public static function none(): ?self { return null; } /** * Signal that we'd like to register the given parser(s) so they can parse the current block */ public static function of(BlockContinueParserInterface ...$blockParsers): self { return new self(...$blockParsers); } /** * Signal that the block parsing process should be aborted (no other block starts should be checked) * * @internal */ public static function abort(): self { $ret = new self(); $ret->isAborting = true; return $ret; } } PK ! +�Y� � , Parser/Block/AbstractBlockContinueParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Block; use League\CommonMark\Node\Block\AbstractBlock; /** * Base class for a block parser * * Slightly more convenient to extend from vs. implementing the interface */ abstract class AbstractBlockContinueParser implements BlockContinueParserInterface { public function isContainer(): bool { return false; } public function canHaveLazyContinuationLines(): bool { return false; } public function canContain(AbstractBlock $childBlock): bool { return false; } public function addLine(string $line): void { } public function closeBlock(): void { } } PK ! l�8�i i 8 Parser/Block/BlockContinueParserWithInlinesInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Block; use League\CommonMark\Parser\InlineParserEngineInterface; interface BlockContinueParserWithInlinesInterface extends BlockContinueParserInterface { /** * Parse any inlines inside of the current block */ public function parseInlines(InlineParserEngineInterface $inlineParser): void; } PK ! b$6 @ @ - Parser/Block/BlockContinueParserInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Block; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Parser\Cursor; /** * Interface for a block continuation parser * * A block continue parser can only handle a single block instance. The current block being parsed is stored within this parser and * can be returned once parsing has completed. If you need to parse multiple block continuations, instantiate a new parser for each one. */ interface BlockContinueParserInterface { /** * Return the current block being parsed by this parser */ public function getBlock(): AbstractBlock; /** * Return whether we are parsing a container block */ public function isContainer(): bool; /** * Return whether we are interested in possibly lazily parsing any subsequent lines */ public function canHaveLazyContinuationLines(): bool; /** * Determine whether the current block being parsed can contain the given child block */ public function canContain(AbstractBlock $childBlock): bool; /** * Attempt to parse the given line */ public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue; /** * Add the given line of text to the current block */ public function addLine(string $line): void; /** * Close and finalize the current block */ public function closeBlock(): void; } PK ! "(�\5 5 $ Parser/Block/DocumentBlockParser.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser\Block; use League\CommonMark\Node\Block\AbstractBlock; use League\CommonMark\Node\Block\Document; use League\CommonMark\Node\Block\Paragraph; use League\CommonMark\Parser\Cursor; use League\CommonMark\Reference\ReferenceMapInterface; /** * Parser implementation which ensures everything is added to the root-level Document */ final class DocumentBlockParser extends AbstractBlockContinueParser { /** @psalm-readonly */ private Document $document; public function __construct(ReferenceMapInterface $referenceMap) { $this->document = new Document($referenceMap); } public function getBlock(): Document { return $this->document; } public function isContainer(): bool { return true; } public function canContain(AbstractBlock $childBlock): bool { return true; } public function tryContinue(Cursor $cursor, BlockContinueParserInterface $activeBlockParser): ?BlockContinue { return BlockContinue::at($cursor); } public function closeBlock(): void { $this->removeLinkReferenceDefinitions(); } private function removeLinkReferenceDefinitions(): void { $emptyNodes = []; $walker = $this->document->walker(); while ($event = $walker->next()) { $node = $event->getNode(); // TODO for v3: It would be great if we could find an alternate way to identify such paragraphs. // Unfortunately, we can't simply check for empty paragraphs here because inlines haven't been processed yet, // meaning all paragraphs will appear blank here, and we don't have a way to check the status of the reference parser // which is attached to the (already-closed) paragraph parser. if ($event->isEntering() && $node instanceof Paragraph && $node->onlyContainsLinkReferenceDefinitions) { $emptyNodes[] = $node; } } foreach ($emptyNodes as $node) { $node->detach(); } } } PK ! x�+y� � & Parser/InlineParserEngineInterface.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser; use League\CommonMark\Node\Block\AbstractBlock; /** * Parser for inline content (text, links, emphasized text, etc). */ interface InlineParserEngineInterface { /** * Parse the given contents as inlines and insert them into the given block */ public function parse(string $contents, AbstractBlock $block): void; } PK ! �J�{` ` Parser/MarkdownParserState.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Parser; use League\CommonMark\Parser\Block\BlockContinueParserInterface; use League\CommonMark\Parser\Block\ParagraphParser; /** * @internal You should rely on the interface instead */ final class MarkdownParserState implements MarkdownParserStateInterface { /** @psalm-readonly */ private BlockContinueParserInterface $activeBlockParser; /** @psalm-readonly */ private BlockContinueParserInterface $lastMatchedBlockParser; public function __construct(BlockContinueParserInterface $activeBlockParser, BlockContinueParserInterface $lastMatchedBlockParser) { $this->activeBlockParser = $activeBlockParser; $this->lastMatchedBlockParser = $lastMatchedBlockParser; } public function getActiveBlockParser(): BlockContinueParserInterface { return $this->activeBlockParser; } public function getLastMatchedBlockParser(): BlockContinueParserInterface { return $this->lastMatchedBlockParser; } public function getParagraphContent(): ?string { if (! $this->lastMatchedBlockParser instanceof ParagraphParser) { return null; } $paragraphParser = $this->lastMatchedBlockParser; $content = $paragraphParser->getContentString(); return $content === '' ? null : $content; } } PK ! �X��� � Util/ArrayCollection.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Util; /** * Array collection * * Provides a wrapper around a standard PHP array. * * @internal * * @phpstan-template T * @phpstan-implements \IteratorAggregate<int, T> * @phpstan-implements \ArrayAccess<int, T> */ final class ArrayCollection implements \IteratorAggregate, \Countable, \ArrayAccess { /** * @var array<int, mixed> * @phpstan-var array<int, T> */ private array $elements; /** * Constructor * * @param array<int|string, mixed> $elements * * @phpstan-param array<int, T> $elements */ public function __construct(array $elements = []) { $this->elements = $elements; } /** * @return mixed|false * * @phpstan-return T|false */ public function first() { return \reset($this->elements); } /** * @return mixed|false * * @phpstan-return T|false */ public function last() { return \end($this->elements); } /** * Retrieve an external iterator * * @return \ArrayIterator<int, mixed> * * @phpstan-return \ArrayIterator<int, T> */ #[\ReturnTypeWillChange] public function getIterator(): \ArrayIterator { return new \ArrayIterator($this->elements); } /** * Count elements of an object * * @return int The count as an integer. */ public function count(): int { return \count($this->elements); } /** * Whether an offset exists * * {@inheritDoc} * * @phpstan-param int $offset */ public function offsetExists($offset): bool { return \array_key_exists($offset, $this->elements); } /** * Offset to retrieve * * {@inheritDoc} * * @phpstan-param int $offset * * @phpstan-return T|null */ #[\ReturnTypeWillChange] public function offsetGet($offset) { return $this->elements[$offset] ?? null; } /** * Offset to set * * {@inheritDoc} * * @phpstan-param int|null $offset * @phpstan-param T $value */ #[\ReturnTypeWillChange] public function offsetSet($offset, $value): void { if ($offset === null) { $this->elements[] = $value; } else { $this->elements[$offset] = $value; } } /** * Offset to unset * * {@inheritDoc} * * @phpstan-param int $offset */ #[\ReturnTypeWillChange] public function offsetUnset($offset): void { if (! \array_key_exists($offset, $this->elements)) { return; } unset($this->elements[$offset]); } /** * Returns a subset of the array * * @return array<int, mixed> * * @phpstan-return array<int, T> */ public function slice(int $offset, ?int $length = null): array { return \array_slice($this->elements, $offset, $length, true); } /** * @return array<int, mixed> * * @phpstan-return array<int, T> */ public function toArray(): array { return $this->elements; } } PK ! y0@, , Util/HtmlElement.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Util; final class HtmlElement implements \Stringable { /** @psalm-readonly */ private string $tagName; /** @var array<string, string|bool> */ private array $attributes = []; /** @var \Stringable|\Stringable[]|string */ private $contents; /** @psalm-readonly */ private bool $selfClosing; /** * @param string $tagName Name of the HTML tag * @param array<string, string|string[]|bool> $attributes Array of attributes (values should be unescaped) * @param \Stringable|\Stringable[]|string|null $contents Inner contents, pre-escaped if needed * @param bool $selfClosing Whether the tag is self-closing */ public function __construct(string $tagName, array $attributes = [], $contents = '', bool $selfClosing = false) { $this->tagName = $tagName; $this->selfClosing = $selfClosing; foreach ($attributes as $name => $value) { $this->setAttribute($name, $value); } $this->setContents($contents ?? ''); } /** @psalm-immutable */ public function getTagName(): string { return $this->tagName; } /** * @return array<string, string|bool> * * @psalm-immutable */ public function getAllAttributes(): array { return $this->attributes; } /** * @return string|bool|null * * @psalm-immutable */ public function getAttribute(string $key) { return $this->attributes[$key] ?? null; } /** * @param string|string[]|bool $value */ public function setAttribute(string $key, $value = true): self { if (\is_array($value)) { $this->attributes[$key] = \implode(' ', \array_unique($value)); } else { $this->attributes[$key] = $value; } return $this; } /** * @return \Stringable|\Stringable[]|string * * @psalm-immutable */ public function getContents(bool $asString = true) { if (! $asString) { return $this->contents; } return $this->getContentsAsString(); } /** * Sets the inner contents of the tag (must be pre-escaped if needed) * * @param \Stringable|\Stringable[]|string $contents * * @return $this */ public function setContents($contents): self { $this->contents = $contents ?? ''; // @phpstan-ignore-line return $this; } /** @psalm-immutable */ public function __toString(): string { $result = '<' . $this->tagName; foreach ($this->attributes as $key => $value) { if ($value === true) { $result .= ' ' . $key; } elseif ($value === false) { continue; } else { $result .= ' ' . $key . '="' . Xml::escape($value) . '"'; } } if ($this->contents !== '') { $result .= '>' . $this->getContentsAsString() . '</' . $this->tagName . '>'; } elseif ($this->selfClosing && $this->tagName === 'input') { $result .= '>'; } elseif ($this->selfClosing) { $result .= ' />'; } else { $result .= '></' . $this->tagName . '>'; } return $result; } /** @psalm-immutable */ private function getContentsAsString(): string { if (\is_string($this->contents)) { return $this->contents; } if (\is_array($this->contents)) { return \implode('', $this->contents); } return (string) $this->contents; } } PK ! BR�(; ; Util/UrlEncoder.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Util; use League\CommonMark\Exception\UnexpectedEncodingException; /** * @psalm-immutable */ final class UrlEncoder { private const ENCODE_CACHE = ['%00', '%01', '%02', '%03', '%04', '%05', '%06', '%07', '%08', '%09', '%0A', '%0B', '%0C', '%0D', '%0E', '%0F', '%10', '%11', '%12', '%13', '%14', '%15', '%16', '%17', '%18', '%19', '%1A', '%1B', '%1C', '%1D', '%1E', '%1F', '%20', '!', '%22', '#', '$', '%25', '&', "'", '(', ')', '*', '+', ',', '-', '.', '/', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', '%3C', '=', '%3E', '?', '@', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '%5B', '%5C', '%5D', '%5E', '_', '%60', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', '%7B', '%7C', '%7D', '~', '%7F']; /** * @throws UnexpectedEncodingException if a non-UTF-8-compatible encoding is used * * @psalm-pure */ public static function unescapeAndEncode(string $uri): string { // Optimization: if the URL only includes characters we know will be kept as-is, then just return the URL as-is. if (\preg_match('/^[A-Za-z0-9~!@#$&*()\-_=+;:,.\/?]+$/', $uri)) { return $uri; } if (! \mb_check_encoding($uri, 'UTF-8')) { throw new UnexpectedEncodingException('Unexpected encoding - UTF-8 or ASCII was expected'); } $result = ''; $chars = \mb_str_split($uri, 1, 'UTF-8'); $l = \count($chars); for ($i = 0; $i < $l; $i++) { $code = $chars[$i]; if ($code === '%' && $i + 2 < $l) { if (\preg_match('/^[0-9a-f]{2}$/i', $chars[$i + 1] . $chars[$i + 2]) === 1) { $result .= '%' . $chars[$i + 1] . $chars[$i + 2]; $i += 2; continue; } } if (\ord($code) < 128) { $result .= self::ENCODE_CACHE[\ord($code)]; continue; } $result .= \rawurlencode($code); } return $result; } } PK ! �!�� � Util/SpecReader.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Util; use League\CommonMark\Exception\IOException; /** * Reads in a CommonMark spec document and extracts the input/output examples for testing against them */ final class SpecReader { private function __construct() { } /** * @return iterable<string, array{input: string, output: string, type: string, section: string, number: int}> */ public static function read(string $data): iterable { // Normalize newlines for platform independence $data = \preg_replace('/\r\n?/', "\n", $data); \assert($data !== null); $data = \preg_replace('/<!-- END TESTS -->.*$/', '', $data); \assert($data !== null); \preg_match_all('/^`{32} (example ?\w*)\n([\s\S]*?)^\.\n([\s\S]*?)^`{32}$|^#{1,6} *(.*)$/m', $data, $matches, PREG_SET_ORDER); $currentSection = 'Example'; $exampleNumber = 0; foreach ($matches as $match) { if (isset($match[4])) { $currentSection = $match[4]; continue; } yield \trim($currentSection . ' #' . $exampleNumber) => [ 'input' => \str_replace('→', "\t", $match[2]), 'output' => \str_replace('→', "\t", $match[3]), 'type' => $match[1], 'section' => $currentSection, 'number' => $exampleNumber++, ]; } } /** * @return iterable<string, array{input: string, output: string, type: string, section: string, number: int}> * * @throws IOException if the file cannot be loaded */ public static function readFile(string $filename): iterable { if (($data = \file_get_contents($filename)) === false) { throw new IOException(\sprintf('Failed to load spec from %s', $filename)); } return self::read($data); } } PK ! �sX� � Util/LinkParserHelper.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Util; use League\CommonMark\Parser\Cursor; /** * @psalm-immutable */ final class LinkParserHelper { /** * Attempt to parse link destination * * @return string|null The string, or null if no match */ public static function parseLinkDestination(Cursor $cursor): ?string { if ($res = $cursor->match(RegexHelper::REGEX_LINK_DESTINATION_BRACES)) { // Chop off surrounding <..>: return UrlEncoder::unescapeAndEncode( RegexHelper::unescape(\substr($res, 1, -1)) ); } if ($cursor->getCurrentCharacter() === '<') { return null; } $destination = self::manuallyParseLinkDestination($cursor); if ($destination === null) { return null; } return UrlEncoder::unescapeAndEncode( RegexHelper::unescape($destination) ); } public static function parseLinkLabel(Cursor $cursor): int { $match = $cursor->match('/^\[(?:[^\\\\\[\]]|\\\\.){0,1000}\]/'); if ($match === null) { return 0; } $length = \mb_strlen($match, 'UTF-8'); if ($length > 1001) { return 0; } return $length; } public static function parsePartialLinkLabel(Cursor $cursor): ?string { return $cursor->match('/^(?:[^\\\\\[\]]+|\\\\.?)*/'); } /** * Attempt to parse link title (sans quotes) * * @return string|null The string, or null if no match */ public static function parseLinkTitle(Cursor $cursor): ?string { if ($title = $cursor->match('/' . RegexHelper::PARTIAL_LINK_TITLE . '/')) { // Chop off quotes from title and unescape return RegexHelper::unescape(\substr($title, 1, -1)); } return null; } public static function parsePartialLinkTitle(Cursor $cursor, string $endDelimiter): ?string { $endDelimiter = \preg_quote($endDelimiter, '/'); $regex = \sprintf('/(%s|[^%s\x00])*(?:%s)?/', RegexHelper::PARTIAL_ESCAPED_CHAR, $endDelimiter, $endDelimiter); if (($partialTitle = $cursor->match($regex)) === null) { return null; } return RegexHelper::unescape($partialTitle); } private static function manuallyParseLinkDestination(Cursor $cursor): ?string { $oldPosition = $cursor->getPosition(); $oldState = $cursor->saveState(); $openParens = 0; while (($c = $cursor->getCurrentCharacter()) !== null) { if ($c === '\\' && ($peek = $cursor->peek()) !== null && RegexHelper::isEscapable($peek)) { $cursor->advanceBy(2); } elseif ($c === '(') { $cursor->advanceBy(1); $openParens++; } elseif ($c === ')') { if ($openParens < 1) { break; } $cursor->advanceBy(1); $openParens--; } elseif (\preg_match(RegexHelper::REGEX_WHITESPACE_CHAR, $c)) { break; } else { $cursor->advanceBy(1); } } if ($openParens !== 0) { return null; } if ($cursor->getPosition() === $oldPosition && (! isset($c) || $c !== ')')) { return null; } $newPos = $cursor->getPosition(); $cursor->restoreState($oldState); $cursor->advanceBy($newPos - $cursor->getPosition()); return $cursor->getPreviousText(); } } PK ! /�j�' �' Util/RegexHelper.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Util; use League\CommonMark\Exception\InvalidArgumentException; use League\CommonMark\Extension\CommonMark\Node\Block\HtmlBlock; /** * Provides regular expressions and utilities for parsing Markdown * * All of the PARTIAL_ regex constants assume that they'll be used in case-insensitive searches * All other complete regexes provided by this class (either via constants or methods) will have case-insensitivity enabled. * * @phpcs:disable Generic.Strings.UnnecessaryStringConcat.Found * * @psalm-immutable */ final class RegexHelper { // Partial regular expressions (wrap with `/` on each side and add the case-insensitive `i` flag before use) public const PARTIAL_ENTITY = '&(?:#x[a-f0-9]{1,6}|#[0-9]{1,7}|[a-z][a-z0-9]{1,31});'; public const PARTIAL_ESCAPABLE = '[!"#$%&\'()*+,.\/:;<=>?@[\\\\\]^_`{|}~-]'; public const PARTIAL_ESCAPED_CHAR = '\\\\' . self::PARTIAL_ESCAPABLE; public const PARTIAL_IN_DOUBLE_QUOTES = '"(' . self::PARTIAL_ESCAPED_CHAR . '|[^"\x00])*"'; public const PARTIAL_IN_SINGLE_QUOTES = '\'(' . self::PARTIAL_ESCAPED_CHAR . '|[^\'\x00])*\''; public const PARTIAL_IN_PARENS = '\\((' . self::PARTIAL_ESCAPED_CHAR . '|[^)\x00])*\\)'; public const PARTIAL_REG_CHAR = '[^\\\\()\x00-\x20]'; public const PARTIAL_IN_PARENS_NOSP = '\((' . self::PARTIAL_REG_CHAR . '|' . self::PARTIAL_ESCAPED_CHAR . '|\\\\)*\)'; public const PARTIAL_TAGNAME = '[a-z][a-z0-9-]*'; public const PARTIAL_BLOCKTAGNAME = '(?:address|article|aside|base|basefont|blockquote|body|caption|center|col|colgroup|dd|details|dialog|dir|div|dl|dt|fieldset|figcaption|figure|footer|form|frame|frameset|h1|head|header|hr|html|iframe|legend|li|link|main|menu|menuitem|nav|noframes|ol|optgroup|option|p|param|search|section|summary|table|tbody|td|tfoot|th|thead|title|tr|track|ul)'; public const PARTIAL_ATTRIBUTENAME = '[a-z_:][a-z0-9:._-]*'; public const PARTIAL_UNQUOTEDVALUE = '[^"\'=<>`\x00-\x20]+'; public const PARTIAL_SINGLEQUOTEDVALUE = '\'[^\']*\''; public const PARTIAL_DOUBLEQUOTEDVALUE = '"[^"]*"'; public const PARTIAL_ATTRIBUTEVALUE = '(?:' . self::PARTIAL_UNQUOTEDVALUE . '|' . self::PARTIAL_SINGLEQUOTEDVALUE . '|' . self::PARTIAL_DOUBLEQUOTEDVALUE . ')'; public const PARTIAL_ATTRIBUTEVALUESPEC = '(?:' . '\s*=' . '\s*' . self::PARTIAL_ATTRIBUTEVALUE . ')'; public const PARTIAL_ATTRIBUTE = '(?:' . '\s+' . self::PARTIAL_ATTRIBUTENAME . self::PARTIAL_ATTRIBUTEVALUESPEC . '?)'; public const PARTIAL_OPENTAG = '<' . self::PARTIAL_TAGNAME . self::PARTIAL_ATTRIBUTE . '*' . '\s*\/?>'; public const PARTIAL_CLOSETAG = '<\/' . self::PARTIAL_TAGNAME . '\s*[>]'; public const PARTIAL_OPENBLOCKTAG = '<' . self::PARTIAL_BLOCKTAGNAME . self::PARTIAL_ATTRIBUTE . '*' . '\s*\/?>'; public const PARTIAL_CLOSEBLOCKTAG = '<\/' . self::PARTIAL_BLOCKTAGNAME . '\s*[>]'; public const PARTIAL_HTMLCOMMENT = '<!-->|<!--->|<!--[\s\S]*?-->'; public const PARTIAL_PROCESSINGINSTRUCTION = '[<][?][\s\S]*?[?][>]'; public const PARTIAL_DECLARATION = '<![A-Za-z]+' . '[^>]*>'; public const PARTIAL_CDATA = '<!\[CDATA\[[\s\S]*?]\]>'; public const PARTIAL_HTMLTAG = '(?:' . self::PARTIAL_OPENTAG . '|' . self::PARTIAL_CLOSETAG . '|' . self::PARTIAL_HTMLCOMMENT . '|' . self::PARTIAL_PROCESSINGINSTRUCTION . '|' . self::PARTIAL_DECLARATION . '|' . self::PARTIAL_CDATA . ')'; public const PARTIAL_HTMLBLOCKOPEN = '<(?:' . self::PARTIAL_BLOCKTAGNAME . '(?:[\s\/>]|$)' . '|' . '\/' . self::PARTIAL_BLOCKTAGNAME . '(?:[\s>]|$)' . '|' . '[?!])'; public const PARTIAL_LINK_TITLE = '^(?:"(' . self::PARTIAL_ESCAPED_CHAR . '|[^"\x00])*"' . '|' . '\'(' . self::PARTIAL_ESCAPED_CHAR . '|[^\'\x00])*\'' . '|' . '\((' . self::PARTIAL_ESCAPED_CHAR . '|[^()\x00])*\))'; public const REGEX_PUNCTUATION = '/^[!"#$%&\'()*+,\-.\\/:;<=>?@\\[\\]\\\\^_`{|}~\p{P}\p{S}]/u'; public const REGEX_UNSAFE_PROTOCOL = '/^javascript:|vbscript:|file:|data:/i'; public const REGEX_SAFE_DATA_PROTOCOL = '/^data:image\/(?:png|gif|jpeg|webp)/i'; public const REGEX_NON_SPACE = '/[^ \t\f\v\r\n]/'; public const REGEX_WHITESPACE_CHAR = '/^[ \t\n\x0b\x0c\x0d]/'; public const REGEX_UNICODE_WHITESPACE_CHAR = '/^\pZ|\s/u'; public const REGEX_THEMATIC_BREAK = '/^(?:\*[ \t]*){3,}$|^(?:_[ \t]*){3,}$|^(?:-[ \t]*){3,}$/'; public const REGEX_LINK_DESTINATION_BRACES = '/^(?:<(?:[^<>\\n\\\\\\x00]|\\\\.)*>)/'; /** * @psalm-pure */ public static function isEscapable(string $character): bool { return \preg_match('/' . self::PARTIAL_ESCAPABLE . '/', $character) === 1; } /** * @psalm-pure */ public static function isLetter(?string $character): bool { if ($character === null) { return false; } return \preg_match('/[\pL]/u', $character) === 1; } /** * Attempt to match a regex in string s at offset offset * * @psalm-param non-empty-string $regex * * @return int|null Index of match, or null * * @psalm-pure */ public static function matchAt(string $regex, string $string, int $offset = 0): ?int { $matches = []; $string = \mb_substr($string, $offset, null, 'UTF-8'); if (! \preg_match($regex, $string, $matches, \PREG_OFFSET_CAPTURE)) { return null; } // PREG_OFFSET_CAPTURE always returns the byte offset, not the char offset, which is annoying $charPos = \mb_strlen(\mb_strcut($string, 0, $matches[0][1], 'UTF-8'), 'UTF-8'); return $offset + $charPos; } /** * Functional wrapper around preg_match_all which only returns the first set of matches * * @psalm-param non-empty-string $pattern * * @return string[]|null * * @psalm-pure */ public static function matchFirst(string $pattern, string $subject, int $offset = 0): ?array { if ($offset !== 0) { $subject = \substr($subject, $offset); } \preg_match_all($pattern, $subject, $matches, \PREG_SET_ORDER); if ($matches === []) { return null; } return $matches[0] ?: null; } /** * Replace backslash escapes with literal characters * * @psalm-pure */ public static function unescape(string $string): string { $allEscapedChar = '/\\\\(' . self::PARTIAL_ESCAPABLE . ')/'; $escaped = \preg_replace($allEscapedChar, '$1', $string); \assert(\is_string($escaped)); return \preg_replace_callback('/' . self::PARTIAL_ENTITY . '/i', static fn ($e) => Html5EntityDecoder::decode($e[0]), $escaped); } /** * @internal * * @param int $type HTML block type * * @psalm-param HtmlBlock::TYPE_* $type * * @phpstan-param HtmlBlock::TYPE_* $type * * @psalm-return non-empty-string * * @throws InvalidArgumentException if an invalid type is given * * @psalm-pure */ public static function getHtmlBlockOpenRegex(int $type): string { switch ($type) { case HtmlBlock::TYPE_1_CODE_CONTAINER: return '/^<(?:script|pre|textarea|style)(?:\s|>|$)/i'; case HtmlBlock::TYPE_2_COMMENT: return '/^<!--/'; case HtmlBlock::TYPE_3: return '/^<[?]/'; case HtmlBlock::TYPE_4: return '/^<![A-Z]/i'; case HtmlBlock::TYPE_5_CDATA: return '/^<!\[CDATA\[/i'; case HtmlBlock::TYPE_6_BLOCK_ELEMENT: return '%^<[/]?(?:address|article|aside|base|basefont|blockquote|body|caption|center|col|colgroup|dd|details|dialog|dir|div|dl|dt|fieldset|figcaption|figure|footer|form|frame|frameset|h[123456]|head|header|hr|html|iframe|legend|li|link|main|menu|menuitem|nav|noframes|ol|optgroup|option|p|param|section|source|summary|table|tbody|td|tfoot|th|thead|title|tr|track|ul)(?:\s|[/]?[>]|$)%i'; case HtmlBlock::TYPE_7_MISC_ELEMENT: return '/^(?:' . self::PARTIAL_OPENTAG . '|' . self::PARTIAL_CLOSETAG . ')\\s*$/i'; default: throw new InvalidArgumentException('Invalid HTML block type'); } } /** * @internal * * @param int $type HTML block type * * @psalm-param HtmlBlock::TYPE_* $type * * @phpstan-param HtmlBlock::TYPE_* $type * * @psalm-return non-empty-string * * @throws InvalidArgumentException if an invalid type is given * * @psalm-pure */ public static function getHtmlBlockCloseRegex(int $type): string { switch ($type) { case HtmlBlock::TYPE_1_CODE_CONTAINER: return '%<\/(?:script|pre|textarea|style)>%i'; case HtmlBlock::TYPE_2_COMMENT: return '/-->/'; case HtmlBlock::TYPE_3: return '/\?>/'; case HtmlBlock::TYPE_4: return '/>/'; case HtmlBlock::TYPE_5_CDATA: return '/\]\]>/'; default: throw new InvalidArgumentException('Invalid HTML block type'); } } /** * @psalm-pure */ public static function isLinkPotentiallyUnsafe(string $url): bool { return \preg_match(self::REGEX_UNSAFE_PROTOCOL, $url) !== 0 && \preg_match(self::REGEX_SAFE_DATA_PROTOCOL, $url) === 0; } } PK ! �My Util/Html5EntityDecoder.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Util; /** * @psalm-immutable */ final class Html5EntityDecoder { /** * @psalm-pure */ public static function decode(string $entity): string { if (\substr($entity, -1) !== ';') { return $entity; } if (\substr($entity, 0, 2) === '&#') { if (\strtolower(\substr($entity, 2, 1)) === 'x') { return self::fromHex(\substr($entity, 3, -1)); } return self::fromDecimal(\substr($entity, 2, -1)); } return \html_entity_decode($entity, \ENT_QUOTES | \ENT_HTML5, 'UTF-8'); } /** * @param mixed $number * * @psalm-pure */ private static function fromDecimal($number): string { // Only convert code points within planes 0-2, excluding NULL // phpcs:ignore Generic.PHP.ForbiddenFunctions.Found if (empty($number) || $number > 0x2FFFF) { return self::fromHex('fffd'); } $entity = '&#' . $number . ';'; $converted = \mb_decode_numericentity($entity, [0x0, 0x2FFFF, 0, 0xFFFF], 'UTF-8'); if ($converted === $entity) { return self::fromHex('fffd'); } return $converted; } /** * @psalm-pure */ private static function fromHex(string $hexChars): string { return self::fromDecimal(\hexdec($hexChars)); } } PK ! )Q�i i Util/PrioritizedList.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Util; /** * @internal * * @phpstan-template T * @phpstan-implements \IteratorAggregate<T> */ final class PrioritizedList implements \IteratorAggregate { /** * @var array<int, array<mixed>> * @phpstan-var array<int, array<T>> */ private array $list = []; /** * @var \Traversable<mixed>|null * @phpstan-var \Traversable<T>|null */ private ?\Traversable $optimized = null; /** * @param mixed $item * * @phpstan-param T $item */ public function add($item, int $priority): void { $this->list[$priority][] = $item; $this->optimized = null; } /** * @return \Traversable<int, mixed> * * @phpstan-return \Traversable<int, T> */ #[\ReturnTypeWillChange] public function getIterator(): \Traversable { if ($this->optimized === null) { \krsort($this->list); $sorted = []; foreach ($this->list as $group) { foreach ($group as $item) { $sorted[] = $item; } } $this->optimized = new \ArrayIterator($sorted); } return $this->optimized; } } PK ! w�?� � Util/Xml.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js) * - (c) John MacFarlane * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Util; /** * Utility class for handling/generating XML and HTML * * @psalm-immutable */ final class Xml { /** * @psalm-pure */ public static function escape(string $string): string { return \str_replace(['&', '<', '>', '"'], ['&', '<', '>', '"'], $string); } } PK ! �ؼ � Util/HtmlFilter.phpnu ȯ�� <?php declare(strict_types=1); /* * This file is part of the league/commonmark package. * * (c) Colin O'Dell <colinodell@gmail.com> * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace League\CommonMark\Util; use League\CommonMark\Exception\InvalidArgumentException; /** * @psalm-immutable */ final class HtmlFilter { // Return the entire string as-is public const ALLOW = 'allow'; // Escape the entire string so any HTML/JS won't be interpreted as such public const ESCAPE = 'escape'; // Return an empty string public const STRIP = 'strip'; /** * Runs the given HTML through the given filter * * @param string $html HTML input to be filtered * @param string $filter One of the HtmlFilter constants * * @return string Filtered HTML * * @throws InvalidArgumentException when an invalid $filter is given * * @psalm-pure */ public static function filter(string $html, string $filter): string { switch ($filter) { case self::STRIP: return ''; case self::ESCAPE: return \htmlspecialchars($html, \ENT_NOQUOTES); case self::ALLOW: return $html; default: throw new InvalidArgumentException(\sprintf('Invalid filter provided: "%s"', $filter)); } } } PK ! �݁�� � BinaryUtils.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid; /** * Provides binary math utilities */ class BinaryUtils { /** * Applies the RFC 4122 variant field to the 16-bit clock sequence * * @link http://tools.ietf.org/html/rfc4122#section-4.1.1 RFC 4122, § 4.1.1: Variant * * @param int $clockSeq The 16-bit clock sequence value before the RFC 4122 * variant is applied * * @return int The 16-bit clock sequence multiplexed with the UUID variant * * @psalm-pure */ public static function applyVariant(int $clockSeq): int { $clockSeq = $clockSeq & 0x3fff; $clockSeq |= 0x8000; return $clockSeq; } /** * Applies the RFC 4122 version number to the 16-bit `time_hi_and_version` field * * @link http://tools.ietf.org/html/rfc4122#section-4.1.3 RFC 4122, § 4.1.3: Version * * @param int $timeHi The value of the 16-bit `time_hi_and_version` field * before the RFC 4122 version is applied * @param int $version The RFC 4122 version to apply to the `time_hi` field * * @return int The 16-bit time_hi field of the timestamp multiplexed with * the UUID version number * * @psalm-pure */ public static function applyVersion(int $timeHi, int $version): int { $timeHi = $timeHi & 0x0fff; $timeHi |= $version << 12; return $timeHi; } } PK ! |l7?�5 �5 DeprecatedUuidMethodsTrait.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid; use DateTimeImmutable; use DateTimeInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Exception\DateTimeException; use Ramsey\Uuid\Exception\UnsupportedOperationException; use Throwable; use function str_pad; use function substr; use const STR_PAD_LEFT; /** * This trait encapsulates deprecated methods for ramsey/uuid; this trait and * its methods will be removed in ramsey/uuid 5.0.0. * * @deprecated This trait and its methods will be removed in ramsey/uuid 5.0.0. * * @psalm-immutable */ trait DeprecatedUuidMethodsTrait { /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getClockSeqHiAndReserved()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. */ public function getClockSeqHiAndReserved(): string { return $this->numberConverter->fromHex($this->fields->getClockSeqHiAndReserved()->toString()); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getClockSeqHiAndReserved()}. */ public function getClockSeqHiAndReservedHex(): string { return $this->fields->getClockSeqHiAndReserved()->toString(); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getClockSeqLow()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. */ public function getClockSeqLow(): string { return $this->numberConverter->fromHex($this->fields->getClockSeqLow()->toString()); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getClockSeqLow()}. */ public function getClockSeqLowHex(): string { return $this->fields->getClockSeqLow()->toString(); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getClockSeq()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. */ public function getClockSequence(): string { return $this->numberConverter->fromHex($this->fields->getClockSeq()->toString()); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getClockSeq()}. */ public function getClockSequenceHex(): string { return $this->fields->getClockSeq()->toString(); } /** * @deprecated This method will be removed in 5.0.0. There is no alternative * recommendation, so plan accordingly. */ public function getNumberConverter(): NumberConverterInterface { return $this->numberConverter; } /** * @deprecated In ramsey/uuid version 5.0.0, this will be removed. * It is available at {@see UuidV1::getDateTime()}. * * @return DateTimeImmutable An immutable instance of DateTimeInterface * * @throws UnsupportedOperationException if UUID is not time-based * @throws DateTimeException if DateTime throws an exception/error */ public function getDateTime(): DateTimeInterface { if ($this->fields->getVersion() !== 1) { throw new UnsupportedOperationException('Not a time-based UUID'); } $time = $this->timeConverter->convertTime($this->fields->getTimestamp()); try { return new DateTimeImmutable( '@' . $time->getSeconds()->toString() . '.' . str_pad($time->getMicroseconds()->toString(), 6, '0', STR_PAD_LEFT) ); } catch (Throwable $e) { throw new DateTimeException($e->getMessage(), (int) $e->getCode(), $e); } } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. * * @return string[] */ public function getFieldsHex(): array { return [ 'time_low' => $this->fields->getTimeLow()->toString(), 'time_mid' => $this->fields->getTimeMid()->toString(), 'time_hi_and_version' => $this->fields->getTimeHiAndVersion()->toString(), 'clock_seq_hi_and_reserved' => $this->fields->getClockSeqHiAndReserved()->toString(), 'clock_seq_low' => $this->fields->getClockSeqLow()->toString(), 'node' => $this->fields->getNode()->toString(), ]; } /** * @deprecated This method will be removed in 5.0.0. There is no direct * alternative, but the same information may be obtained by splitting * in half the value returned by {@see UuidInterface::getHex()}. */ public function getLeastSignificantBits(): string { $leastSignificantHex = substr($this->getHex()->toString(), 16); return $this->numberConverter->fromHex($leastSignificantHex); } /** * @deprecated This method will be removed in 5.0.0. There is no direct * alternative, but the same information may be obtained by splitting * in half the value returned by {@see UuidInterface::getHex()}. */ public function getLeastSignificantBitsHex(): string { return substr($this->getHex()->toString(), 16); } /** * @deprecated This method will be removed in 5.0.0. There is no direct * alternative, but the same information may be obtained by splitting * in half the value returned by {@see UuidInterface::getHex()}. */ public function getMostSignificantBits(): string { $mostSignificantHex = substr($this->getHex()->toString(), 0, 16); return $this->numberConverter->fromHex($mostSignificantHex); } /** * @deprecated This method will be removed in 5.0.0. There is no direct * alternative, but the same information may be obtained by splitting * in half the value returned by {@see UuidInterface::getHex()}. */ public function getMostSignificantBitsHex(): string { return substr($this->getHex()->toString(), 0, 16); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getNode()} and use the * arbitrary-precision math library of your choice to convert it to a * string integer. */ public function getNode(): string { return $this->numberConverter->fromHex($this->fields->getNode()->toString()); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getNode()}. */ public function getNodeHex(): string { return $this->fields->getNode()->toString(); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimeHiAndVersion()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. */ public function getTimeHiAndVersion(): string { return $this->numberConverter->fromHex($this->fields->getTimeHiAndVersion()->toString()); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimeHiAndVersion()}. */ public function getTimeHiAndVersionHex(): string { return $this->fields->getTimeHiAndVersion()->toString(); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimeLow()} and use the * arbitrary-precision math library of your choice to convert it to a * string integer. */ public function getTimeLow(): string { return $this->numberConverter->fromHex($this->fields->getTimeLow()->toString()); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimeLow()}. */ public function getTimeLowHex(): string { return $this->fields->getTimeLow()->toString(); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimeMid()} and use the * arbitrary-precision math library of your choice to convert it to a * string integer. */ public function getTimeMid(): string { return $this->numberConverter->fromHex($this->fields->getTimeMid()->toString()); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimeMid()}. */ public function getTimeMidHex(): string { return $this->fields->getTimeMid()->toString(); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimestamp()} and use * the arbitrary-precision math library of your choice to convert it to * a string integer. */ public function getTimestamp(): string { if ($this->fields->getVersion() !== 1) { throw new UnsupportedOperationException('Not a time-based UUID'); } return $this->numberConverter->fromHex($this->fields->getTimestamp()->toString()); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimestamp()}. */ public function getTimestampHex(): string { if ($this->fields->getVersion() !== 1) { throw new UnsupportedOperationException('Not a time-based UUID'); } return $this->fields->getTimestamp()->toString(); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getVariant()}. */ public function getVariant(): ?int { return $this->fields->getVariant(); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see \Ramsey\Uuid\Fields\FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getVersion()}. */ public function getVersion(): ?int { return $this->fields->getVersion(); } } PK ! ��}u� � Rfc4122/UuidV3.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface; use Ramsey\Uuid\Uuid; /** * Version 3 UUIDs are named-based, using combination of a namespace and name * that are hashed into a 128-bit unsigned integer using MD5 * * @psalm-immutable */ final class UuidV3 extends Uuid implements UuidInterface { /** * Creates a version 3 (name-based, MD5-hashed) UUID * * @param Rfc4122FieldsInterface $fields The fields from which to construct a UUID * @param NumberConverterInterface $numberConverter The number converter to use * for converting hex values to/from integers * @param CodecInterface $codec The codec to use when encoding or decoding * UUID strings * @param TimeConverterInterface $timeConverter The time converter to use * for converting timestamps extracted from a UUID to unix timestamps */ public function __construct( Rfc4122FieldsInterface $fields, NumberConverterInterface $numberConverter, CodecInterface $codec, TimeConverterInterface $timeConverter ) { if ($fields->getVersion() !== Uuid::UUID_TYPE_HASH_MD5) { throw new InvalidArgumentException( 'Fields used to create a UuidV3 must represent a ' . 'version 3 (name-based, MD5-hashed) UUID' ); } parent::__construct($fields, $numberConverter, $codec, $timeConverter); } } PK ! .��% % Rfc4122/UuidV8.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface; use Ramsey\Uuid\Uuid; /** * Version 8, Custom UUIDs provide an RFC 4122 compatible format for * experimental or vendor-specific uses * * The only requirement for version 8 UUIDs is that the version and variant bits * must be set. Otherwise, implementations are free to set the other bits * according to their needs. As a result, the uniqueness of version 8 UUIDs is * implementation-specific and should not be assumed. * * @link https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.8 UUID Version 8 * * @psalm-immutable */ final class UuidV8 extends Uuid implements UuidInterface { /** * Creates a version 8 (custom) UUID * * @param Rfc4122FieldsInterface $fields The fields from which to construct a UUID * @param NumberConverterInterface $numberConverter The number converter to use * for converting hex values to/from integers * @param CodecInterface $codec The codec to use when encoding or decoding * UUID strings * @param TimeConverterInterface $timeConverter The time converter to use * for converting timestamps extracted from a UUID to unix timestamps */ public function __construct( Rfc4122FieldsInterface $fields, NumberConverterInterface $numberConverter, CodecInterface $codec, TimeConverterInterface $timeConverter ) { if ($fields->getVersion() !== Uuid::UUID_TYPE_CUSTOM) { throw new InvalidArgumentException( 'Fields used to create a UuidV8 must represent a ' . 'version 8 (custom) UUID' ); } parent::__construct($fields, $numberConverter, $codec, $timeConverter); } } PK ! ���Z# # Rfc4122/FieldsInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Fields\FieldsInterface as BaseFieldsInterface; use Ramsey\Uuid\Type\Hexadecimal; /** * RFC 4122 defines fields for a specific variant of UUID * * The fields of an RFC 4122 variant UUID are: * * * **time_low**: The low field of the timestamp, an unsigned 32-bit integer * * **time_mid**: The middle field of the timestamp, an unsigned 16-bit integer * * **time_hi_and_version**: The high field of the timestamp multiplexed with * the version number, an unsigned 16-bit integer * * **clock_seq_hi_and_reserved**: The high field of the clock sequence * multiplexed with the variant, an unsigned 8-bit integer * * **clock_seq_low**: The low field of the clock sequence, an unsigned * 8-bit integer * * **node**: The spatially unique node identifier, an unsigned 48-bit * integer * * @link http://tools.ietf.org/html/rfc4122#section-4.1 RFC 4122, § 4.1: Format * * @psalm-immutable */ interface FieldsInterface extends BaseFieldsInterface { /** * Returns the full 16-bit clock sequence, with the variant bits (two most * significant bits) masked out */ public function getClockSeq(): Hexadecimal; /** * Returns the high field of the clock sequence multiplexed with the variant */ public function getClockSeqHiAndReserved(): Hexadecimal; /** * Returns the low field of the clock sequence */ public function getClockSeqLow(): Hexadecimal; /** * Returns the node field */ public function getNode(): Hexadecimal; /** * Returns the high field of the timestamp multiplexed with the version */ public function getTimeHiAndVersion(): Hexadecimal; /** * Returns the low field of the timestamp */ public function getTimeLow(): Hexadecimal; /** * Returns the middle field of the timestamp */ public function getTimeMid(): Hexadecimal; /** * Returns the full 60-bit timestamp, without the version */ public function getTimestamp(): Hexadecimal; /** * Returns the variant * * The variant number describes the layout of the UUID. The variant * number has the following meaning: * * - 0 - Reserved for NCS backward compatibility * - 2 - The RFC 4122 variant * - 6 - Reserved, Microsoft Corporation backward compatibility * - 7 - Reserved for future definition * * For RFC 4122 variant UUIDs, this value should always be the integer `2`. * * @link http://tools.ietf.org/html/rfc4122#section-4.1.1 RFC 4122, § 4.1.1: Variant */ public function getVariant(): int; /** * Returns the version * * The version number describes how the UUID was generated and has the * following meaning: * * 1. Gregorian time UUID * 2. DCE security UUID * 3. Name-based UUID hashed with MD5 * 4. Randomly generated UUID * 5. Name-based UUID hashed with SHA-1 * 6. Reordered time UUID * 7. Unix Epoch time UUID * * This returns `null` if the UUID is not an RFC 4122 variant, since version * is only meaningful for this variant. * * @link http://tools.ietf.org/html/rfc4122#section-4.1.3 RFC 4122, § 4.1.3: Version */ public function getVersion(): ?int; /** * Returns true if these fields represent a nil UUID * * The nil UUID is special form of UUID that is specified to have all 128 * bits set to zero. */ public function isNil(): bool; } PK ! ��; ; Rfc4122/UuidV7.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface; use Ramsey\Uuid\Uuid; /** * Unix Epoch time, or version 7, UUIDs include a timestamp in milliseconds * since the Unix Epoch, along with random bytes * * @link https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.7 UUID Version 7 * * @psalm-immutable */ final class UuidV7 extends Uuid implements UuidInterface { use TimeTrait; /** * Creates a version 7 (Unix Epoch time) UUID * * @param Rfc4122FieldsInterface $fields The fields from which to construct a UUID * @param NumberConverterInterface $numberConverter The number converter to use * for converting hex values to/from integers * @param CodecInterface $codec The codec to use when encoding or decoding * UUID strings * @param TimeConverterInterface $timeConverter The time converter to use * for converting timestamps extracted from a UUID to unix timestamps */ public function __construct( Rfc4122FieldsInterface $fields, NumberConverterInterface $numberConverter, CodecInterface $codec, TimeConverterInterface $timeConverter ) { if ($fields->getVersion() !== Uuid::UUID_TYPE_UNIX_TIME) { throw new InvalidArgumentException( 'Fields used to create a UuidV7 must represent a ' . 'version 7 (Unix Epoch time) UUID' ); } parent::__construct($fields, $numberConverter, $codec, $timeConverter); } } PK ! z��� � Rfc4122/UuidV5.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface; use Ramsey\Uuid\Uuid; /** * Version 5 UUIDs are named-based, using combination of a namespace and name * that are hashed into a 128-bit unsigned integer using SHA1 * * @psalm-immutable */ final class UuidV5 extends Uuid implements UuidInterface { /** * Creates a version 5 (name-based, SHA1-hashed) UUID * * @param Rfc4122FieldsInterface $fields The fields from which to construct a UUID * @param NumberConverterInterface $numberConverter The number converter to use * for converting hex values to/from integers * @param CodecInterface $codec The codec to use when encoding or decoding * UUID strings * @param TimeConverterInterface $timeConverter The time converter to use * for converting timestamps extracted from a UUID to unix timestamps */ public function __construct( Rfc4122FieldsInterface $fields, NumberConverterInterface $numberConverter, CodecInterface $codec, TimeConverterInterface $timeConverter ) { if ($fields->getVersion() !== Uuid::UUID_TYPE_HASH_SHA1) { throw new InvalidArgumentException( 'Fields used to create a UuidV5 must represent a ' . 'version 5 (named-based, SHA1-hashed) UUID' ); } parent::__construct($fields, $numberConverter, $codec, $timeConverter); } } PK ! ��> > Rfc4122/MaxUuid.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Uuid; /** * The max UUID is special form of UUID that is specified to have all 128 bits * set to one * * @psalm-immutable */ final class MaxUuid extends Uuid implements UuidInterface { } PK ! f��[� � Rfc4122/UuidV1.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface; use Ramsey\Uuid\Uuid; /** * Gregorian time, or version 1, UUIDs include timestamp, clock sequence, and node * values that are combined into a 128-bit unsigned integer * * @psalm-immutable */ final class UuidV1 extends Uuid implements UuidInterface { use TimeTrait; /** * Creates a version 1 (Gregorian time) UUID * * @param Rfc4122FieldsInterface $fields The fields from which to construct a UUID * @param NumberConverterInterface $numberConverter The number converter to use * for converting hex values to/from integers * @param CodecInterface $codec The codec to use when encoding or decoding * UUID strings * @param TimeConverterInterface $timeConverter The time converter to use * for converting timestamps extracted from a UUID to unix timestamps */ public function __construct( Rfc4122FieldsInterface $fields, NumberConverterInterface $numberConverter, CodecInterface $codec, TimeConverterInterface $timeConverter ) { if ($fields->getVersion() !== Uuid::UUID_TYPE_TIME) { throw new InvalidArgumentException( 'Fields used to create a UuidV1 must represent a ' . 'version 1 (time-based) UUID' ); } parent::__construct($fields, $numberConverter, $codec, $timeConverter); } } PK ! /���� � Rfc4122/TimeTrait.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use DateTimeImmutable; use DateTimeInterface; use Ramsey\Uuid\Exception\DateTimeException; use Throwable; use function str_pad; use const STR_PAD_LEFT; /** * Provides common functionality for getting the time from a time-based UUID * * @psalm-immutable */ trait TimeTrait { /** * Returns a DateTimeInterface object representing the timestamp associated * with the UUID * * @return DateTimeImmutable A PHP DateTimeImmutable instance representing * the timestamp of a time-based UUID */ public function getDateTime(): DateTimeInterface { $time = $this->timeConverter->convertTime($this->fields->getTimestamp()); try { return new DateTimeImmutable( '@' . $time->getSeconds()->toString() . '.' . str_pad($time->getMicroseconds()->toString(), 6, '0', STR_PAD_LEFT) ); } catch (Throwable $e) { throw new DateTimeException($e->getMessage(), (int) $e->getCode(), $e); } } } PK ! ��bn Rfc4122/MaxTrait.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; /** * Provides common functionality for max UUIDs * * The max UUID is special form of UUID that is specified to have all 128 bits * set to one. It is the inverse of the nil UUID. * * @link https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.10 Max UUID * * @psalm-immutable */ trait MaxTrait { /** * Returns the bytes that comprise the fields */ abstract public function getBytes(): string; /** * Returns true if the byte string represents a max UUID */ public function isMax(): bool { return $this->getBytes() === "\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff\xff"; } } PK ! ��*� � Rfc4122/Validator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Uuid; use Ramsey\Uuid\Validator\ValidatorInterface; use function preg_match; use function str_replace; /** * Rfc4122\Validator validates strings as UUIDs of the RFC 4122 variant * * @psalm-immutable */ final class Validator implements ValidatorInterface { private const VALID_PATTERN = '\A[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-' . '[1-8][0-9A-Fa-f]{3}-[ABab89][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}\z'; /** * @psalm-return non-empty-string * @psalm-suppress MoreSpecificReturnType we know that the retrieved `string` is never empty * @psalm-suppress LessSpecificReturnStatement we know that the retrieved `string` is never empty */ public function getPattern(): string { return self::VALID_PATTERN; } public function validate(string $uuid): bool { $uuid = str_replace(['urn:', 'uuid:', 'URN:', 'UUID:', '{', '}'], '', $uuid); $uuid = strtolower($uuid); return $uuid === Uuid::NIL || $uuid === Uuid::MAX || preg_match('/' . self::VALID_PATTERN . '/Dms', $uuid); } } PK ! ���J J Rfc4122/Fields.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Fields\SerializableFieldsTrait; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Uuid; use function bin2hex; use function dechex; use function hexdec; use function sprintf; use function str_pad; use function strlen; use function substr; use function unpack; use const STR_PAD_LEFT; /** * RFC 4122 variant UUIDs are comprised of a set of named fields * * Internally, this class represents the fields together as a 16-byte binary * string. * * @psalm-immutable */ final class Fields implements FieldsInterface { use MaxTrait; use NilTrait; use SerializableFieldsTrait; use VariantTrait; use VersionTrait; /** * @param string $bytes A 16-byte binary string representation of a UUID * * @throws InvalidArgumentException if the byte string is not exactly 16 bytes * @throws InvalidArgumentException if the byte string does not represent an RFC 4122 UUID * @throws InvalidArgumentException if the byte string does not contain a valid version */ public function __construct(private string $bytes) { if (strlen($this->bytes) !== 16) { throw new InvalidArgumentException( 'The byte string must be 16 bytes long; ' . 'received ' . strlen($this->bytes) . ' bytes' ); } if (!$this->isCorrectVariant()) { throw new InvalidArgumentException( 'The byte string received does not conform to the RFC 4122 variant' ); } if (!$this->isCorrectVersion()) { throw new InvalidArgumentException( 'The byte string received does not contain a valid RFC 4122 version' ); } } public function getBytes(): string { return $this->bytes; } public function getClockSeq(): Hexadecimal { if ($this->isMax()) { $clockSeq = 0xffff; } elseif ($this->isNil()) { $clockSeq = 0x0000; } else { $clockSeq = hexdec(bin2hex(substr($this->bytes, 8, 2))) & 0x3fff; } return new Hexadecimal(str_pad(dechex($clockSeq), 4, '0', STR_PAD_LEFT)); } public function getClockSeqHiAndReserved(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 8, 1))); } public function getClockSeqLow(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 9, 1))); } public function getNode(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 10))); } public function getTimeHiAndVersion(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 6, 2))); } public function getTimeLow(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 0, 4))); } public function getTimeMid(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 4, 2))); } /** * Returns the full 60-bit timestamp, without the version * * For version 2 UUIDs, the time_low field is the local identifier and * should not be returned as part of the time. For this reason, we set the * bottom 32 bits of the timestamp to 0's. As a result, there is some loss * of fidelity of the timestamp, for version 2 UUIDs. The timestamp can be * off by a range of 0 to 429.4967295 seconds (or 7 minutes, 9 seconds, and * 496730 microseconds). * * For version 6 UUIDs, the timestamp order is reversed from the typical RFC * 4122 order (the time bits are in the correct bit order, so that it is * monotonically increasing). In returning the timestamp value, we put the * bits in the order: time_low + time_mid + time_hi. */ public function getTimestamp(): Hexadecimal { $timestamp = match ($this->getVersion()) { Uuid::UUID_TYPE_DCE_SECURITY => sprintf( '%03x%04s%08s', hexdec($this->getTimeHiAndVersion()->toString()) & 0x0fff, $this->getTimeMid()->toString(), '' ), Uuid::UUID_TYPE_REORDERED_TIME => sprintf( '%08s%04s%03x', $this->getTimeLow()->toString(), $this->getTimeMid()->toString(), hexdec($this->getTimeHiAndVersion()->toString()) & 0x0fff ), // The Unix timestamp in version 7 UUIDs is a 48-bit number, // but for consistency, we will return a 60-bit number, padded // to the left with zeros. Uuid::UUID_TYPE_UNIX_TIME => sprintf( '%011s%04s', $this->getTimeLow()->toString(), $this->getTimeMid()->toString(), ), default => sprintf( '%03x%04s%08s', hexdec($this->getTimeHiAndVersion()->toString()) & 0x0fff, $this->getTimeMid()->toString(), $this->getTimeLow()->toString() ), }; return new Hexadecimal($timestamp); } public function getVersion(): ?int { if ($this->isNil() || $this->isMax()) { return null; } /** @var int[] $parts */ $parts = unpack('n*', $this->bytes); return $parts[4] >> 12; } private function isCorrectVariant(): bool { if ($this->isNil() || $this->isMax()) { return true; } return $this->getVariant() === Uuid::RFC_4122; } } PK ! �>� x x Rfc4122/VariantTrait.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Exception\InvalidBytesException; use Ramsey\Uuid\Uuid; use function decbin; use function str_pad; use function str_starts_with; use function strlen; use function substr; use function unpack; use const STR_PAD_LEFT; /** * Provides common functionality for handling the variant, as defined by RFC 4122 * * @psalm-immutable */ trait VariantTrait { /** * Returns the bytes that comprise the fields */ abstract public function getBytes(): string; /** * Returns the variant identifier, according to RFC 4122, for the given bytes * * The following values may be returned: * * - `0` -- Reserved, NCS backward compatibility. * - `2` -- The variant specified in RFC 4122. * - `6` -- Reserved, Microsoft Corporation backward compatibility. * - `7` -- Reserved for future definition. * * @link https://tools.ietf.org/html/rfc4122#section-4.1.1 RFC 4122, § 4.1.1: Variant * * @return int The variant identifier, according to RFC 4122 */ public function getVariant(): int { if (strlen($this->getBytes()) !== 16) { throw new InvalidBytesException('Invalid number of bytes'); } if ($this->isMax() || $this->isNil()) { // RFC 4122 defines these special types of UUID, so we will consider // them as belonging to the RFC 4122 variant. return Uuid::RFC_4122; } /** @var int[] $parts */ $parts = unpack('n*', $this->getBytes()); // $parts[5] is a 16-bit, unsigned integer containing the variant bits // of the UUID. We convert this integer into a string containing a // binary representation, padded to 16 characters. We analyze the first // three characters (three most-significant bits) to determine the // variant. $binary = str_pad( decbin($parts[5]), 16, '0', STR_PAD_LEFT ); $msb = substr($binary, 0, 3); if ($msb === '111') { return Uuid::RESERVED_FUTURE; } elseif ($msb === '110') { return Uuid::RESERVED_MICROSOFT; } elseif (str_starts_with($msb, '10')) { return Uuid::RFC_4122; } return Uuid::RESERVED_NCS; } } PK ! ����� � Rfc4122/UuidV4.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface; use Ramsey\Uuid\Uuid; /** * Random, or version 4, UUIDs are randomly or pseudo-randomly generated 128-bit * integers * * @psalm-immutable */ final class UuidV4 extends Uuid implements UuidInterface { /** * Creates a version 4 (random) UUID * * @param Rfc4122FieldsInterface $fields The fields from which to construct a UUID * @param NumberConverterInterface $numberConverter The number converter to use * for converting hex values to/from integers * @param CodecInterface $codec The codec to use when encoding or decoding * UUID strings * @param TimeConverterInterface $timeConverter The time converter to use * for converting timestamps extracted from a UUID to unix timestamps */ public function __construct( Rfc4122FieldsInterface $fields, NumberConverterInterface $numberConverter, CodecInterface $codec, TimeConverterInterface $timeConverter ) { if ($fields->getVersion() !== Uuid::UUID_TYPE_RANDOM) { throw new InvalidArgumentException( 'Fields used to create a UuidV4 must represent a ' . 'version 4 (random) UUID' ); } parent::__construct($fields, $numberConverter, $codec, $timeConverter); } } PK ! �� � � Rfc4122/VersionTrait.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Uuid; /** * Provides common functionality for handling the version, as defined by RFC 4122 * * @psalm-immutable */ trait VersionTrait { /** * Returns the version */ abstract public function getVersion(): ?int; /** * Returns true if these fields represent a max UUID */ abstract public function isMax(): bool; /** * Returns true if these fields represent a nil UUID */ abstract public function isNil(): bool; /** * Returns true if the version matches one of those defined by RFC 4122 * * @return bool True if the UUID version is valid, false otherwise */ private function isCorrectVersion(): bool { if ($this->isNil() || $this->isMax()) { return true; } return match ($this->getVersion()) { Uuid::UUID_TYPE_TIME, Uuid::UUID_TYPE_DCE_SECURITY, Uuid::UUID_TYPE_HASH_MD5, Uuid::UUID_TYPE_RANDOM, Uuid::UUID_TYPE_HASH_SHA1, Uuid::UUID_TYPE_REORDERED_TIME, Uuid::UUID_TYPE_UNIX_TIME, Uuid::UUID_TYPE_CUSTOM => true, default => false, }; } } PK ! cM�? ? Rfc4122/NilUuid.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Uuid; /** * The nil UUID is special form of UUID that is specified to have all 128 bits * set to zero * * @psalm-immutable */ final class NilUuid extends Uuid implements UuidInterface { } PK ! f�>�� � Rfc4122/UuidBuilder.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Builder\UuidBuilderInterface; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\Time\UnixTimeConverter; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\UnableToBuildUuidException; use Ramsey\Uuid\Exception\UnsupportedOperationException; use Ramsey\Uuid\Math\BrickMathCalculator; use Ramsey\Uuid\Rfc4122\UuidInterface as Rfc4122UuidInterface; use Ramsey\Uuid\Uuid; use Ramsey\Uuid\UuidInterface; use Throwable; /** * UuidBuilder builds instances of RFC 4122 UUIDs * * @psalm-immutable */ class UuidBuilder implements UuidBuilderInterface { private TimeConverterInterface $unixTimeConverter; /** * Constructs the DefaultUuidBuilder * * @param NumberConverterInterface $numberConverter The number converter to * use when constructing the Uuid * @param TimeConverterInterface $timeConverter The time converter to use * for converting Gregorian time extracted from version 1, 2, and 6 * UUIDs to Unix timestamps * @param TimeConverterInterface|null $unixTimeConverter The time converter * to use for converter Unix Epoch time extracted from version 7 UUIDs * to Unix timestamps */ public function __construct( private NumberConverterInterface $numberConverter, private TimeConverterInterface $timeConverter, ?TimeConverterInterface $unixTimeConverter = null ) { $this->unixTimeConverter = $unixTimeConverter ?? new UnixTimeConverter(new BrickMathCalculator()); } /** * Builds and returns a Uuid * * @param CodecInterface $codec The codec to use for building this Uuid instance * @param string $bytes The byte string from which to construct a UUID * * @return Rfc4122UuidInterface UuidBuilder returns instances of Rfc4122UuidInterface * * @psalm-pure */ public function build(CodecInterface $codec, string $bytes): UuidInterface { try { /** @var Fields $fields */ $fields = $this->buildFields($bytes); if ($fields->isNil()) { return new NilUuid($fields, $this->numberConverter, $codec, $this->timeConverter); } if ($fields->isMax()) { return new MaxUuid($fields, $this->numberConverter, $codec, $this->timeConverter); } switch ($fields->getVersion()) { case Uuid::UUID_TYPE_TIME: return new UuidV1($fields, $this->numberConverter, $codec, $this->timeConverter); case Uuid::UUID_TYPE_DCE_SECURITY: return new UuidV2($fields, $this->numberConverter, $codec, $this->timeConverter); case Uuid::UUID_TYPE_HASH_MD5: return new UuidV3($fields, $this->numberConverter, $codec, $this->timeConverter); case Uuid::UUID_TYPE_RANDOM: return new UuidV4($fields, $this->numberConverter, $codec, $this->timeConverter); case Uuid::UUID_TYPE_HASH_SHA1: return new UuidV5($fields, $this->numberConverter, $codec, $this->timeConverter); case Uuid::UUID_TYPE_REORDERED_TIME: return new UuidV6($fields, $this->numberConverter, $codec, $this->timeConverter); case Uuid::UUID_TYPE_UNIX_TIME: return new UuidV7($fields, $this->numberConverter, $codec, $this->unixTimeConverter); case Uuid::UUID_TYPE_CUSTOM: return new UuidV8($fields, $this->numberConverter, $codec, $this->timeConverter); } throw new UnsupportedOperationException( 'The UUID version in the given fields is not supported ' . 'by this UUID builder' ); } catch (Throwable $e) { throw new UnableToBuildUuidException($e->getMessage(), (int) $e->getCode(), $e); } } /** * Proxy method to allow injecting a mock, for testing */ protected function buildFields(string $bytes): FieldsInterface { return new Fields($bytes); } } PK ! '���� � Rfc4122/NilTrait.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; /** * Provides common functionality for nil UUIDs * * The nil UUID is special form of UUID that is specified to have all 128 bits * set to zero. * * @link https://tools.ietf.org/html/rfc4122#section-4.1.7 RFC 4122, § 4.1.7: Nil UUID * * @psalm-immutable */ trait NilTrait { /** * Returns the bytes that comprise the fields */ abstract public function getBytes(): string; /** * Returns true if the byte string represents a nil UUID */ public function isNil(): bool { return $this->getBytes() === "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0"; } } PK ! w=� � Rfc4122/UuidInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\UuidInterface as BaseUuidInterface; /** * Also known as a Leach-Salz variant UUID, an RFC 4122 variant UUID is a * universally unique identifier defined by RFC 4122 * * @link https://tools.ietf.org/html/rfc4122 RFC 4122 * * @psalm-immutable */ interface UuidInterface extends BaseUuidInterface { } PK ! _~v�� � Rfc4122/UuidV2.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface; use Ramsey\Uuid\Type\Integer as IntegerObject; use Ramsey\Uuid\Uuid; use function hexdec; /** * DCE Security version, or version 2, UUIDs include local domain identifier, * local ID for the specified domain, and node values that are combined into a * 128-bit unsigned integer * * It is important to note that a version 2 UUID suffers from some loss of * fidelity of the timestamp, due to replacing the time_low field with the * local identifier. When constructing the timestamp value for date * purposes, we replace the local identifier bits with zeros. As a result, * the timestamp can be off by a range of 0 to 429.4967295 seconds (or 7 * minutes, 9 seconds, and 496730 microseconds). * * Astute observers might note this value directly corresponds to 2^32 - 1, * or 0xffffffff. The local identifier is 32-bits, and we have set each of * these bits to 0, so the maximum range of timestamp drift is 0x00000000 * to 0xffffffff (counted in 100-nanosecond intervals). * * @link https://publications.opengroup.org/c311 DCE 1.1: Authentication and Security Services * @link https://publications.opengroup.org/c706 DCE 1.1: Remote Procedure Call * @link https://pubs.opengroup.org/onlinepubs/9696989899/chap5.htm#tagcjh_08_02_01_01 DCE 1.1: Auth & Sec, §5.2.1.1 * @link https://pubs.opengroup.org/onlinepubs/9696989899/chap11.htm#tagcjh_14_05_01_01 DCE 1.1: Auth & Sec, §11.5.1.1 * @link https://pubs.opengroup.org/onlinepubs/9629399/apdxa.htm DCE 1.1: RPC, Appendix A * @link https://github.com/google/uuid Go package for UUIDs (includes DCE implementation) * * @psalm-immutable */ final class UuidV2 extends Uuid implements UuidInterface { use TimeTrait; /** * Creates a version 2 (DCE Security) UUID * * @param Rfc4122FieldsInterface $fields The fields from which to construct a UUID * @param NumberConverterInterface $numberConverter The number converter to use * for converting hex values to/from integers * @param CodecInterface $codec The codec to use when encoding or decoding * UUID strings * @param TimeConverterInterface $timeConverter The time converter to use * for converting timestamps extracted from a UUID to unix timestamps */ public function __construct( Rfc4122FieldsInterface $fields, NumberConverterInterface $numberConverter, CodecInterface $codec, TimeConverterInterface $timeConverter ) { if ($fields->getVersion() !== Uuid::UUID_TYPE_DCE_SECURITY) { throw new InvalidArgumentException( 'Fields used to create a UuidV2 must represent a ' . 'version 2 (DCE Security) UUID' ); } parent::__construct($fields, $numberConverter, $codec, $timeConverter); } /** * Returns the local domain used to create this version 2 UUID */ public function getLocalDomain(): int { /** @var Rfc4122FieldsInterface $fields */ $fields = $this->getFields(); return (int) hexdec($fields->getClockSeqLow()->toString()); } /** * Returns the string name of the local domain */ public function getLocalDomainName(): string { return Uuid::DCE_DOMAIN_NAMES[$this->getLocalDomain()]; } /** * Returns the local identifier for the domain used to create this version 2 UUID */ public function getLocalIdentifier(): IntegerObject { /** @var Rfc4122FieldsInterface $fields */ $fields = $this->getFields(); return new IntegerObject( $this->numberConverter->fromHex($fields->getTimeLow()->toString()) ); } } PK ! ��� Rfc4122/UuidV6.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Rfc4122; use Ramsey\Uuid\Nonstandard\UuidV6 as NonstandardUuidV6; /** * Reordered time, or version 6, UUIDs include timestamp, clock sequence, and * node values that are combined into a 128-bit unsigned integer * * @link https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.6 UUID Version 6 * * @psalm-immutable */ final class UuidV6 extends NonstandardUuidV6 implements UuidInterface { } PK ! �96 6 DegradedUuid.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid; /** * @deprecated DegradedUuid is no longer necessary to represent UUIDs on 32-bit * systems. Transition typehints to {@see UuidInterface}. * * @psalm-immutable */ class DegradedUuid extends Uuid { } PK ! Zj�� � Math/RoundingMode.phpnu ȯ�� <?php /** * This file was originally part of brick/math * * Copyright (c) 2013-present Benjamin Morel * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. * * @link https://github.com/brick/math brick/math at GitHub */ declare(strict_types=1); namespace Ramsey\Uuid\Math; /** * Specifies a rounding behavior for numerical operations capable of discarding * precision. * * Each rounding mode indicates how the least significant returned digit of a * rounded result is to be calculated. If fewer digits are returned than the * digits needed to represent the exact numerical result, the discarded digits * will be referred to as the discarded fraction regardless the digits' * contribution to the value of the number. In other words, considered as a * numerical value, the discarded fraction could have an absolute value greater * than one. */ final class RoundingMode { /** * Private constructor. This class is not instantiable. * * @codeCoverageIgnore */ private function __construct() { } /** * Asserts that the requested operation has an exact result, hence no * rounding is necessary. */ public const UNNECESSARY = 0; /** * Rounds away from zero. * * Always increments the digit prior to a nonzero discarded fraction. * Note that this rounding mode never decreases the magnitude of the * calculated value. */ public const UP = 1; /** * Rounds towards zero. * * Never increments the digit prior to a discarded fraction (i.e., * truncates). Note that this rounding mode never increases the magnitude of * the calculated value. */ public const DOWN = 2; /** * Rounds towards positive infinity. * * If the result is positive, behaves as for UP; if negative, behaves as for * DOWN. Note that this rounding mode never decreases the calculated value. */ public const CEILING = 3; /** * Rounds towards negative infinity. * * If the result is positive, behave as for DOWN; if negative, behave as for * UP. Note that this rounding mode never increases the calculated value. */ public const FLOOR = 4; /** * Rounds towards "nearest neighbor" unless both neighbors are equidistant, * in which case round up. * * Behaves as for UP if the discarded fraction is >= 0.5; otherwise, behaves * as for DOWN. Note that this is the rounding mode commonly taught at * school. */ public const HALF_UP = 5; /** * Rounds towards "nearest neighbor" unless both neighbors are equidistant, * in which case round down. * * Behaves as for UP if the discarded fraction is > 0.5; otherwise, behaves * as for DOWN. */ public const HALF_DOWN = 6; /** * Rounds towards "nearest neighbor" unless both neighbors are equidistant, * in which case round towards positive infinity. * * If the result is positive, behaves as for HALF_UP; if negative, behaves * as for HALF_DOWN. */ public const HALF_CEILING = 7; /** * Rounds towards "nearest neighbor" unless both neighbors are equidistant, * in which case round towards negative infinity. * * If the result is positive, behaves as for HALF_DOWN; if negative, behaves * as for HALF_UP. */ public const HALF_FLOOR = 8; /** * Rounds towards the "nearest neighbor" unless both neighbors are * equidistant, in which case rounds towards the even neighbor. * * Behaves as for HALF_UP if the digit to the left of the discarded fraction * is odd; behaves as for HALF_DOWN if it's even. * * Note that this is the rounding mode that statistically minimizes * cumulative error when applied repeatedly over a sequence of calculations. * It is sometimes known as "Banker's rounding", and is chiefly used in the * USA. */ public const HALF_EVEN = 9; } PK ! ��|�( ( Math/BrickMathCalculator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Math; use Brick\Math\BigDecimal; use Brick\Math\BigInteger; use Brick\Math\Exception\MathException; use Brick\Math\RoundingMode as BrickMathRounding; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Type\Decimal; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; use Ramsey\Uuid\Type\NumberInterface; /** * A calculator using the brick/math library for arbitrary-precision arithmetic * * @psalm-immutable */ final class BrickMathCalculator implements CalculatorInterface { private const ROUNDING_MODE_MAP = [ RoundingMode::UNNECESSARY => BrickMathRounding::UNNECESSARY, RoundingMode::UP => BrickMathRounding::UP, RoundingMode::DOWN => BrickMathRounding::DOWN, RoundingMode::CEILING => BrickMathRounding::CEILING, RoundingMode::FLOOR => BrickMathRounding::FLOOR, RoundingMode::HALF_UP => BrickMathRounding::HALF_UP, RoundingMode::HALF_DOWN => BrickMathRounding::HALF_DOWN, RoundingMode::HALF_CEILING => BrickMathRounding::HALF_CEILING, RoundingMode::HALF_FLOOR => BrickMathRounding::HALF_FLOOR, RoundingMode::HALF_EVEN => BrickMathRounding::HALF_EVEN, ]; public function add(NumberInterface $augend, NumberInterface ...$addends): NumberInterface { $sum = BigInteger::of($augend->toString()); foreach ($addends as $addend) { $sum = $sum->plus($addend->toString()); } return new IntegerObject((string) $sum); } public function subtract(NumberInterface $minuend, NumberInterface ...$subtrahends): NumberInterface { $difference = BigInteger::of($minuend->toString()); foreach ($subtrahends as $subtrahend) { $difference = $difference->minus($subtrahend->toString()); } return new IntegerObject((string) $difference); } public function multiply(NumberInterface $multiplicand, NumberInterface ...$multipliers): NumberInterface { $product = BigInteger::of($multiplicand->toString()); foreach ($multipliers as $multiplier) { $product = $product->multipliedBy($multiplier->toString()); } return new IntegerObject((string) $product); } public function divide( int $roundingMode, int $scale, NumberInterface $dividend, NumberInterface ...$divisors ): NumberInterface { $brickRounding = $this->getBrickRoundingMode($roundingMode); $quotient = BigDecimal::of($dividend->toString()); foreach ($divisors as $divisor) { $quotient = $quotient->dividedBy($divisor->toString(), $scale, $brickRounding); } if ($scale === 0) { return new IntegerObject((string) $quotient->toBigInteger()); } return new Decimal((string) $quotient); } public function fromBase(string $value, int $base): IntegerObject { try { return new IntegerObject((string) BigInteger::fromBase($value, $base)); } catch (MathException | \InvalidArgumentException $exception) { throw new InvalidArgumentException( $exception->getMessage(), (int) $exception->getCode(), $exception ); } } public function toBase(IntegerObject $value, int $base): string { try { return BigInteger::of($value->toString())->toBase($base); } catch (MathException | \InvalidArgumentException $exception) { throw new InvalidArgumentException( $exception->getMessage(), (int) $exception->getCode(), $exception ); } } public function toHexadecimal(IntegerObject $value): Hexadecimal { return new Hexadecimal($this->toBase($value, 16)); } public function toInteger(Hexadecimal $value): IntegerObject { return $this->fromBase($value->toString(), 16); } /** * Maps ramsey/uuid rounding modes to those used by brick/math * * @return BrickMathRounding::* */ private function getBrickRoundingMode(int $roundingMode) { return self::ROUNDING_MODE_MAP[$roundingMode] ?? BrickMathRounding::UNNECESSARY; } } PK ! �GU�~ ~ Math/CalculatorInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Math; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; use Ramsey\Uuid\Type\NumberInterface; /** * A calculator performs arithmetic operations on numbers * * @psalm-immutable */ interface CalculatorInterface { /** * Returns the sum of all the provided parameters * * @param NumberInterface $augend The first addend (the integer being added to) * @param NumberInterface ...$addends The additional integers to a add to the augend * * @return NumberInterface The sum of all the parameters */ public function add(NumberInterface $augend, NumberInterface ...$addends): NumberInterface; /** * Returns the difference of all the provided parameters * * @param NumberInterface $minuend The integer being subtracted from * @param NumberInterface ...$subtrahends The integers to subtract from the minuend * * @return NumberInterface The difference after subtracting all parameters */ public function subtract(NumberInterface $minuend, NumberInterface ...$subtrahends): NumberInterface; /** * Returns the product of all the provided parameters * * @param NumberInterface $multiplicand The integer to be multiplied * @param NumberInterface ...$multipliers The factors by which to multiply the multiplicand * * @return NumberInterface The product of multiplying all the provided parameters */ public function multiply(NumberInterface $multiplicand, NumberInterface ...$multipliers): NumberInterface; /** * Returns the quotient of the provided parameters divided left-to-right * * @param int $roundingMode The RoundingMode constant to use for this operation * @param int $scale The scale to use for this operation * @param NumberInterface $dividend The integer to be divided * @param NumberInterface ...$divisors The integers to divide $dividend by, in * the order in which the division operations should take place * (left-to-right) * * @return NumberInterface The quotient of dividing the provided parameters left-to-right */ public function divide( int $roundingMode, int $scale, NumberInterface $dividend, NumberInterface ...$divisors ): NumberInterface; /** * Converts a value from an arbitrary base to a base-10 integer value * * @param string $value The value to convert * @param int $base The base to convert from (i.e., 2, 16, 32, etc.) * * @return IntegerObject The base-10 integer value of the converted value */ public function fromBase(string $value, int $base): IntegerObject; /** * Converts a base-10 integer value to an arbitrary base * * @param IntegerObject $value The integer value to convert * @param int $base The base to convert to (i.e., 2, 16, 32, etc.) * * @return string The value represented in the specified base */ public function toBase(IntegerObject $value, int $base): string; /** * Converts an Integer instance to a Hexadecimal instance */ public function toHexadecimal(IntegerObject $value): Hexadecimal; /** * Converts a Hexadecimal instance to an Integer instance */ public function toInteger(Hexadecimal $value): IntegerObject; } PK ! �ve�D D & Exception/BuilderNotFoundException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use RuntimeException as PhpRuntimeException; /** * Thrown to indicate that no suitable builder could be found */ class BuilderNotFoundException extends PhpRuntimeException implements UuidExceptionInterface { } PK ! R�� � $ Exception/UuidExceptionInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use Throwable; interface UuidExceptionInterface extends Throwable { } PK ! �o�uR R # Exception/InvalidBytesException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use RuntimeException as PhpRuntimeException; /** * Thrown to indicate that the bytes being operated on are invalid in some way */ class InvalidBytesException extends PhpRuntimeException implements UuidExceptionInterface { } PK ! ���T T Exception/DateTimeException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use RuntimeException as PhpRuntimeException; /** * Thrown to indicate that the PHP DateTime extension encountered an exception/error */ class DateTimeException extends PhpRuntimeException implements UuidExceptionInterface { } PK ! ���Y Y Exception/NameException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use RuntimeException as PhpRuntimeException; /** * Thrown to indicate that an error occurred while attempting to hash a * namespace and name */ class NameException extends PhpRuntimeException implements UuidExceptionInterface { } PK ! . �S S Exception/NodeException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use RuntimeException as PhpRuntimeException; /** * Thrown to indicate that attempting to fetch or create a node ID encountered an error */ class NodeException extends PhpRuntimeException implements UuidExceptionInterface { } PK ! N�� � ( Exception/InvalidUuidStringException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; /** * Thrown to indicate that the string received is not a valid UUID * * The InvalidArgumentException that this extends is the ramsey/uuid version * of this exception. It exists in the same namespace as this class. */ class InvalidUuidStringException extends InvalidArgumentException implements UuidExceptionInterface { } PK ! o� �c c " Exception/DceSecurityException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use RuntimeException as PhpRuntimeException; /** * Thrown to indicate an exception occurred while dealing with DCE Security * (version 2) UUIDs */ class DceSecurityException extends PhpRuntimeException implements UuidExceptionInterface { } PK ! 3t�N� � # Exception/RandomSourceException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use RuntimeException as PhpRuntimeException; /** * Thrown to indicate that the source of random data encountered an error * * This exception is used mostly to indicate that random_bytes() or random_int() * threw an exception. However, it may be used for other sources of random data. */ class RandomSourceException extends PhpRuntimeException implements UuidExceptionInterface { } PK ! �>I I + Exception/UnsupportedOperationException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use LogicException as PhpLogicException; /** * Thrown to indicate that the requested operation is not supported */ class UnsupportedOperationException extends PhpLogicException implements UuidExceptionInterface { } PK ! � =D D ! Exception/TimeSourceException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use RuntimeException as PhpRuntimeException; /** * Thrown to indicate that the source of time encountered an error */ class TimeSourceException extends PhpRuntimeException implements UuidExceptionInterface { } PK ! H%�_B B ( Exception/UnableToBuildUuidException.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Exception; use RuntimeException as PhpRuntimeException; /** * Thrown to indicate a builder is unable to build a UUID */ class UnableToBuildUuidException extends PhpRuntimeException implements UuidExceptionInterface { } PK ! ��C� � Validator/ValidatorInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Validator; /** * A validator validates a string as a proper UUID * * @psalm-immutable */ interface ValidatorInterface { /** * Returns the regular expression pattern used by this validator * * @return string The regular expression pattern this validator uses * * @psalm-return non-empty-string */ public function getPattern(): string; /** * Returns true if the provided string represents a UUID * * @param string $uuid The string to validate as a UUID * * @return bool True if the string is a valid UUID, false otherwise */ public function validate(string $uuid): bool; } PK ! m4t:j j Validator/GenericValidator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Validator; use Ramsey\Uuid\Uuid; use function preg_match; use function str_replace; /** * GenericValidator validates strings as UUIDs of any variant * * @psalm-immutable */ final class GenericValidator implements ValidatorInterface { /** * Regular expression pattern for matching a UUID of any variant. */ private const VALID_PATTERN = '\A[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}\z'; /** * @psalm-return non-empty-string * @psalm-suppress MoreSpecificReturnType we know that the retrieved `string` is never empty * @psalm-suppress LessSpecificReturnStatement we know that the retrieved `string` is never empty */ public function getPattern(): string { return self::VALID_PATTERN; } public function validate(string $uuid): bool { $uuid = str_replace(['urn:', 'uuid:', 'URN:', 'UUID:', '{', '}'], '', $uuid); return $uuid === Uuid::NIL || preg_match('/' . self::VALID_PATTERN . '/Dms', $uuid); } } PK ! #<�� � UuidFactoryInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid; use DateTimeInterface; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; use Ramsey\Uuid\Validator\ValidatorInterface; /** * UuidFactoryInterface defines common functionality all `UuidFactory` instances * must implement */ interface UuidFactoryInterface { /** * Creates a UUID from a byte string * * @param string $bytes A binary string * * @return UuidInterface A UuidInterface instance created from a binary * string representation * * @psalm-pure */ public function fromBytes(string $bytes): UuidInterface; /** * Creates a UUID from a DateTimeInterface instance * * @param DateTimeInterface $dateTime The date and time * @param Hexadecimal|null $node A 48-bit number representing the hardware * address * @param int|null $clockSeq A 14-bit number used to help avoid duplicates * that could arise when the clock is set backwards in time or if the * node ID changes * * @return UuidInterface A UuidInterface instance that represents a * version 1 UUID created from a DateTimeInterface instance */ public function fromDateTime( DateTimeInterface $dateTime, ?Hexadecimal $node = null, ?int $clockSeq = null ): UuidInterface; /** * Creates a UUID from a 128-bit integer string * * @param string $integer String representation of 128-bit integer * * @return UuidInterface A UuidInterface instance created from the string * representation of a 128-bit integer * * @psalm-pure */ public function fromInteger(string $integer): UuidInterface; /** * Creates a UUID from the string standard representation * * @param string $uuid A hexadecimal string * * @return UuidInterface A UuidInterface instance created from a hexadecimal * string representation * * @psalm-pure */ public function fromString(string $uuid): UuidInterface; /** * Returns the validator to use for the factory * * @psalm-mutation-free */ public function getValidator(): ValidatorInterface; /** * Returns a version 1 (Gregorian time) UUID from a host ID, sequence number, * and the current time * * @param Hexadecimal|int|string|null $node A 48-bit number representing the * hardware address; this number may be represented as an integer or a * hexadecimal string * @param int|null $clockSeq A 14-bit number used to help avoid duplicates * that could arise when the clock is set backwards in time or if the * node ID changes * * @return UuidInterface A UuidInterface instance that represents a * version 1 UUID */ public function uuid1($node = null, ?int $clockSeq = null): UuidInterface; /** * Returns a version 2 (DCE Security) UUID from a local domain, local * identifier, host ID, clock sequence, and the current time * * @param int $localDomain The local domain to use when generating bytes, * according to DCE Security * @param IntegerObject|null $localIdentifier The local identifier for the * given domain; this may be a UID or GID on POSIX systems, if the local * domain is person or group, or it may be a site-defined identifier * if the local domain is org * @param Hexadecimal|null $node A 48-bit number representing the hardware * address * @param int|null $clockSeq A 14-bit number used to help avoid duplicates * that could arise when the clock is set backwards in time or if the * node ID changes * * @return UuidInterface A UuidInterface instance that represents a * version 2 UUID */ public function uuid2( int $localDomain, ?IntegerObject $localIdentifier = null, ?Hexadecimal $node = null, ?int $clockSeq = null ): UuidInterface; /** * Returns a version 3 (name-based) UUID based on the MD5 hash of a * namespace ID and a name * * @param string|UuidInterface $ns The namespace (must be a valid UUID) * @param string $name The name to use for creating a UUID * * @return UuidInterface A UuidInterface instance that represents a * version 3 UUID * * @psalm-pure */ public function uuid3($ns, string $name): UuidInterface; /** * Returns a version 4 (random) UUID * * @return UuidInterface A UuidInterface instance that represents a * version 4 UUID */ public function uuid4(): UuidInterface; /** * Returns a version 5 (name-based) UUID based on the SHA-1 hash of a * namespace ID and a name * * @param string|UuidInterface $ns The namespace (must be a valid UUID) * @param string $name The name to use for creating a UUID * * @return UuidInterface A UuidInterface instance that represents a * version 5 UUID * * @psalm-pure */ public function uuid5($ns, string $name): UuidInterface; /** * Returns a version 6 (reordered time) UUID from a host ID, sequence number, * and the current time * * @param Hexadecimal|null $node A 48-bit number representing the hardware * address * @param int|null $clockSeq A 14-bit number used to help avoid duplicates * that could arise when the clock is set backwards in time or if the * node ID changes * * @return UuidInterface A UuidInterface instance that represents a * version 6 UUID */ public function uuid6(?Hexadecimal $node = null, ?int $clockSeq = null): UuidInterface; } PK ! ��f��E �E Lazy/LazyUuidFromString.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Lazy; use DateTimeInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Exception\UnsupportedOperationException; use Ramsey\Uuid\Fields\FieldsInterface; use Ramsey\Uuid\Rfc4122\UuidV1; use Ramsey\Uuid\Rfc4122\UuidV6; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; use Ramsey\Uuid\UuidFactory; use Ramsey\Uuid\UuidInterface; use ValueError; use function assert; use function bin2hex; use function hex2bin; use function sprintf; use function str_replace; use function substr; /** * Lazy version of a UUID: its format has not been determined yet, so it is mostly only usable for string/bytes * conversion. This object optimizes instantiation, serialization and string conversion time, at the cost of * increased overhead for more advanced UUID operations. * * @internal this type is used internally for performance reasons, and is not supposed to be directly referenced * in consumer libraries. * * @psalm-immutable * * Note: the {@see FieldsInterface} does not declare methods that deprecated API * relies upon: the API has been ported from the {@see \Ramsey\Uuid\Uuid} definition, * and is deprecated anyway. * Note: the deprecated API from {@see \Ramsey\Uuid\Uuid} is in use here (on purpose): it will be removed * once the deprecated API is gone from this class too. * * @psalm-suppress UndefinedInterfaceMethod * @psalm-suppress DeprecatedMethod */ final class LazyUuidFromString implements UuidInterface { public const VALID_REGEX = '/\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\z/ms'; private ?UuidInterface $unwrapped = null; /** * @psalm-param non-empty-string $uuid */ public function __construct(private string $uuid) { } /** @psalm-pure */ public static function fromBytes(string $bytes): self { $base16Uuid = bin2hex($bytes); return new self( substr($base16Uuid, 0, 8) . '-' . substr($base16Uuid, 8, 4) . '-' . substr($base16Uuid, 12, 4) . '-' . substr($base16Uuid, 16, 4) . '-' . substr($base16Uuid, 20, 12) ); } public function serialize(): string { return $this->uuid; } /** * @return array{string: string} * * @psalm-return array{string: non-empty-string} */ public function __serialize(): array { return ['string' => $this->uuid]; } /** * {@inheritDoc} * * @param string $data * * @psalm-param non-empty-string $data */ public function unserialize(string $data): void { $this->uuid = $data; } /** * @param array{string?: string} $data * * @psalm-param array{string?: non-empty-string} $data * @psalm-suppress UnusedMethodCall */ public function __unserialize(array $data): void { // @codeCoverageIgnoreStart if (!isset($data['string'])) { throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__)); } // @codeCoverageIgnoreEnd $this->unserialize($data['string']); } /** @psalm-suppress DeprecatedMethod */ public function getNumberConverter(): NumberConverterInterface { return ($this->unwrapped ?? $this->unwrap()) ->getNumberConverter(); } /** * {@inheritDoc} * * @psalm-suppress DeprecatedMethod */ public function getFieldsHex(): array { return ($this->unwrapped ?? $this->unwrap()) ->getFieldsHex(); } /** @psalm-suppress DeprecatedMethod */ public function getClockSeqHiAndReservedHex(): string { return ($this->unwrapped ?? $this->unwrap()) ->getClockSeqHiAndReservedHex(); } /** @psalm-suppress DeprecatedMethod */ public function getClockSeqLowHex(): string { return ($this->unwrapped ?? $this->unwrap()) ->getClockSeqLowHex(); } /** @psalm-suppress DeprecatedMethod */ public function getClockSequenceHex(): string { return ($this->unwrapped ?? $this->unwrap()) ->getClockSequenceHex(); } /** @psalm-suppress DeprecatedMethod */ public function getDateTime(): DateTimeInterface { return ($this->unwrapped ?? $this->unwrap()) ->getDateTime(); } /** @psalm-suppress DeprecatedMethod */ public function getLeastSignificantBitsHex(): string { return ($this->unwrapped ?? $this->unwrap()) ->getLeastSignificantBitsHex(); } /** @psalm-suppress DeprecatedMethod */ public function getMostSignificantBitsHex(): string { return ($this->unwrapped ?? $this->unwrap()) ->getMostSignificantBitsHex(); } /** @psalm-suppress DeprecatedMethod */ public function getNodeHex(): string { return ($this->unwrapped ?? $this->unwrap()) ->getNodeHex(); } /** @psalm-suppress DeprecatedMethod */ public function getTimeHiAndVersionHex(): string { return ($this->unwrapped ?? $this->unwrap()) ->getTimeHiAndVersionHex(); } /** @psalm-suppress DeprecatedMethod */ public function getTimeLowHex(): string { return ($this->unwrapped ?? $this->unwrap()) ->getTimeLowHex(); } /** @psalm-suppress DeprecatedMethod */ public function getTimeMidHex(): string { return ($this->unwrapped ?? $this->unwrap()) ->getTimeMidHex(); } /** @psalm-suppress DeprecatedMethod */ public function getTimestampHex(): string { return ($this->unwrapped ?? $this->unwrap()) ->getTimestampHex(); } /** @psalm-suppress DeprecatedMethod */ public function getUrn(): string { return ($this->unwrapped ?? $this->unwrap()) ->getUrn(); } /** @psalm-suppress DeprecatedMethod */ public function getVariant(): ?int { return ($this->unwrapped ?? $this->unwrap()) ->getVariant(); } /** @psalm-suppress DeprecatedMethod */ public function getVersion(): ?int { return ($this->unwrapped ?? $this->unwrap()) ->getVersion(); } public function compareTo(UuidInterface $other): int { return ($this->unwrapped ?? $this->unwrap()) ->compareTo($other); } public function equals(?object $other): bool { if (! $other instanceof UuidInterface) { return false; } return $this->uuid === $other->toString(); } /** * {@inheritDoc} * * @psalm-suppress MoreSpecificReturnType * @psalm-suppress LessSpecificReturnStatement we know that {@see self::$uuid} is a non-empty string, so * we know that {@see hex2bin} will retrieve a non-empty string too. */ public function getBytes(): string { /** @phpstan-ignore-next-line PHPStan complains that this is not a non-empty-string. */ return (string) hex2bin(str_replace('-', '', $this->uuid)); } public function getFields(): FieldsInterface { return ($this->unwrapped ?? $this->unwrap()) ->getFields(); } public function getHex(): Hexadecimal { return ($this->unwrapped ?? $this->unwrap()) ->getHex(); } public function getInteger(): IntegerObject { return ($this->unwrapped ?? $this->unwrap()) ->getInteger(); } public function toString(): string { return $this->uuid; } public function __toString(): string { return $this->uuid; } public function jsonSerialize(): string { return $this->uuid; } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a {@see Rfc4122FieldsInterface} * instance, you may call {@see Rfc4122FieldsInterface::getClockSeqHiAndReserved()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. * * @psalm-suppress UndefinedInterfaceMethod * @psalm-suppress DeprecatedMethod * @psalm-suppress MixedArgument * @psalm-suppress MixedMethodCall */ public function getClockSeqHiAndReserved(): string { $instance = ($this->unwrapped ?? $this->unwrap()); return $instance->getNumberConverter() ->fromHex( $instance->getFields() ->getClockSeqHiAndReserved() ->toString() ); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a {@see Rfc4122FieldsInterface} * instance, you may call {@see Rfc4122FieldsInterface::getClockSeqLow()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. * * @psalm-suppress UndefinedInterfaceMethod * @psalm-suppress DeprecatedMethod * @psalm-suppress MixedArgument * @psalm-suppress MixedMethodCall */ public function getClockSeqLow(): string { $instance = ($this->unwrapped ?? $this->unwrap()); return $instance->getNumberConverter() ->fromHex( $instance->getFields() ->getClockSeqLow() ->toString() ); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a {@see Rfc4122FieldsInterface} * instance, you may call {@see Rfc4122FieldsInterface::getClockSeq()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. * * @psalm-suppress UndefinedInterfaceMethod * @psalm-suppress DeprecatedMethod * @psalm-suppress MixedArgument * @psalm-suppress MixedMethodCall */ public function getClockSequence(): string { $instance = ($this->unwrapped ?? $this->unwrap()); return $instance->getNumberConverter() ->fromHex( $instance->getFields() ->getClockSeq() ->toString() ); } /** * @deprecated This method will be removed in 5.0.0. There is no direct * alternative, but the same information may be obtained by splitting * in half the value returned by {@see UuidInterface::getHex()}. * * @psalm-suppress UndefinedInterfaceMethod * @psalm-suppress DeprecatedMethod * @psalm-suppress MixedArgument * @psalm-suppress MixedMethodCall */ public function getLeastSignificantBits(): string { $instance = ($this->unwrapped ?? $this->unwrap()); return $instance->getNumberConverter() ->fromHex(substr($instance->getHex()->toString(), 16)); } /** * @deprecated This method will be removed in 5.0.0. There is no direct * alternative, but the same information may be obtained by splitting * in half the value returned by {@see UuidInterface::getHex()}. * * @psalm-suppress UndefinedInterfaceMethod * @psalm-suppress DeprecatedMethod * @psalm-suppress MixedArgument * @psalm-suppress MixedMethodCall */ public function getMostSignificantBits(): string { $instance = ($this->unwrapped ?? $this->unwrap()); return $instance->getNumberConverter() ->fromHex(substr($instance->getHex()->toString(), 0, 16)); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a {@see Rfc4122FieldsInterface} * instance, you may call {@see Rfc4122FieldsInterface::getNode()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. * * @psalm-suppress UndefinedInterfaceMethod * @psalm-suppress DeprecatedMethod * @psalm-suppress MixedArgument * @psalm-suppress MixedMethodCall */ public function getNode(): string { $instance = ($this->unwrapped ?? $this->unwrap()); return $instance->getNumberConverter() ->fromHex( $instance->getFields() ->getNode() ->toString() ); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a {@see Rfc4122FieldsInterface} * instance, you may call {@see Rfc4122FieldsInterface::getTimeHiAndVersion()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. * * @psalm-suppress UndefinedInterfaceMethod * @psalm-suppress DeprecatedMethod * @psalm-suppress MixedArgument * @psalm-suppress MixedMethodCall */ public function getTimeHiAndVersion(): string { $instance = ($this->unwrapped ?? $this->unwrap()); return $instance->getNumberConverter() ->fromHex( $instance->getFields() ->getTimeHiAndVersion() ->toString() ); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a {@see Rfc4122FieldsInterface} * instance, you may call {@see Rfc4122FieldsInterface::getTimeLow()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. * * @psalm-suppress UndefinedInterfaceMethod * @psalm-suppress DeprecatedMethod * @psalm-suppress MixedArgument * @psalm-suppress MixedMethodCall */ public function getTimeLow(): string { $instance = ($this->unwrapped ?? $this->unwrap()); return $instance->getNumberConverter() ->fromHex( $instance->getFields() ->getTimeLow() ->toString() ); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a {@see Rfc4122FieldsInterface} * instance, you may call {@see Rfc4122FieldsInterface::getTimeMid()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. * * @psalm-suppress UndefinedInterfaceMethod * @psalm-suppress DeprecatedMethod * @psalm-suppress MixedArgument * @psalm-suppress MixedMethodCall */ public function getTimeMid(): string { $instance = ($this->unwrapped ?? $this->unwrap()); return $instance->getNumberConverter() ->fromHex( $instance->getFields() ->getTimeMid() ->toString() ); } /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a {@see Rfc4122FieldsInterface} * instance, you may call {@see Rfc4122FieldsInterface::getTimestamp()} * and use the arbitrary-precision math library of your choice to * convert it to a string integer. * * @psalm-suppress UndefinedInterfaceMethod * @psalm-suppress DeprecatedMethod * @psalm-suppress MixedArgument * @psalm-suppress MixedMethodCall */ public function getTimestamp(): string { $instance = ($this->unwrapped ?? $this->unwrap()); $fields = $instance->getFields(); if ($fields->getVersion() !== 1) { throw new UnsupportedOperationException('Not a time-based UUID'); } return $instance->getNumberConverter() ->fromHex($fields->getTimestamp()->toString()); } public function toUuidV1(): UuidV1 { $instance = ($this->unwrapped ?? $this->unwrap()); if ($instance instanceof UuidV1) { return $instance; } assert($instance instanceof UuidV6); return $instance->toUuidV1(); } public function toUuidV6(): UuidV6 { $instance = ($this->unwrapped ?? $this->unwrap()); assert($instance instanceof UuidV6); return $instance; } /** * @psalm-suppress ImpureMethodCall the retrieval of the factory is a clear violation of purity here: this is a * known pitfall of the design of this library, where a value object contains * a mutable reference to a factory. We use a fixed factory here, so the violation * will not have real-world effects, as this object is only instantiated with the * default factory settings/features. * @psalm-suppress InaccessibleProperty property {@see $unwrapped} is used as a cache: we don't expose it to the * outside world, so we should be fine here. */ private function unwrap(): UuidInterface { return $this->unwrapped = (new UuidFactory()) ->fromString($this->uuid); } } PK ! �MŎ- - DeprecatedUuidInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid; use DateTimeInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; /** * This interface encapsulates deprecated methods for ramsey/uuid * * @psalm-immutable */ interface DeprecatedUuidInterface { /** * @deprecated This method will be removed in 5.0.0. There is no alternative * recommendation, so plan accordingly. */ public function getNumberConverter(): NumberConverterInterface; /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. * * @return string[] */ public function getFieldsHex(): array; /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getClockSeqHiAndReserved()}. */ public function getClockSeqHiAndReservedHex(): string; /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getClockSeqLow()}. */ public function getClockSeqLowHex(): string; /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getClockSeq()}. */ public function getClockSequenceHex(): string; /** * @deprecated In ramsey/uuid version 5.0.0, this will be removed from the * interface. It is available at {@see UuidV1::getDateTime()}. */ public function getDateTime(): DateTimeInterface; /** * @deprecated This method will be removed in 5.0.0. There is no direct * alternative, but the same information may be obtained by splitting * in half the value returned by {@see UuidInterface::getHex()}. */ public function getLeastSignificantBitsHex(): string; /** * @deprecated This method will be removed in 5.0.0. There is no direct * alternative, but the same information may be obtained by splitting * in half the value returned by {@see UuidInterface::getHex()}. */ public function getMostSignificantBitsHex(): string; /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getNode()}. */ public function getNodeHex(): string; /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimeHiAndVersion()}. */ public function getTimeHiAndVersionHex(): string; /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimeLow()}. */ public function getTimeLowHex(): string; /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimeMid()}. */ public function getTimeMidHex(): string; /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getTimestamp()}. */ public function getTimestampHex(): string; /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getVariant()}. */ public function getVariant(): ?int; /** * @deprecated Use {@see UuidInterface::getFields()} to get a * {@see FieldsInterface} instance. If it is a * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface} instance, you may call * {@see \Ramsey\Uuid\Rfc4122\FieldsInterface::getVersion()}. */ public function getVersion(): ?int; } PK ! TD,\� � Type/Hexadecimal.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Type; use Ramsey\Uuid\Exception\InvalidArgumentException; use ValueError; use function preg_match; use function sprintf; use function substr; /** * A value object representing a hexadecimal number * * This class exists for type-safety purposes, to ensure that hexadecimal numbers * returned from ramsey/uuid methods as strings are truly hexadecimal and not some * other kind of string. * * @psalm-immutable */ final class Hexadecimal implements TypeInterface { private string $value; /** * @param self|string $value The hexadecimal value to store */ public function __construct(self | string $value) { $this->value = $value instanceof self ? (string) $value : $this->prepareValue($value); } public function toString(): string { return $this->value; } public function __toString(): string { return $this->toString(); } public function jsonSerialize(): string { return $this->toString(); } public function serialize(): string { return $this->toString(); } /** * @return array{string: string} */ public function __serialize(): array { return ['string' => $this->toString()]; } /** * Constructs the object from a serialized string representation * * @param string $data The serialized string representation of the object * * @psalm-suppress UnusedMethodCall */ public function unserialize(string $data): void { $this->__construct($data); } /** * @param array{string?: string} $data */ public function __unserialize(array $data): void { // @codeCoverageIgnoreStart if (!isset($data['string'])) { throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__)); } // @codeCoverageIgnoreEnd $this->unserialize($data['string']); } private function prepareValue(string $value): string { $value = strtolower($value); if (str_starts_with($value, '0x')) { $value = substr($value, 2); } if (!preg_match('/^[A-Fa-f0-9]+$/', $value)) { throw new InvalidArgumentException( 'Value must be a hexadecimal number' ); } return $value; } } PK ! x��x x Type/Time.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Type; use Ramsey\Uuid\Exception\UnsupportedOperationException; use Ramsey\Uuid\Type\Integer as IntegerObject; use ValueError; use function json_decode; use function json_encode; use function sprintf; /** * A value object representing a timestamp * * This class exists for type-safety purposes, to ensure that timestamps used * by ramsey/uuid are truly timestamp integers and not some other kind of string * or integer. * * @psalm-immutable */ final class Time implements TypeInterface { private IntegerObject $seconds; private IntegerObject $microseconds; public function __construct( float | int | string | IntegerObject $seconds, float | int | string | IntegerObject $microseconds = 0, ) { $this->seconds = new IntegerObject($seconds); $this->microseconds = new IntegerObject($microseconds); } public function getSeconds(): IntegerObject { return $this->seconds; } public function getMicroseconds(): IntegerObject { return $this->microseconds; } public function toString(): string { return $this->seconds->toString() . '.' . sprintf('%06s', $this->microseconds->toString()); } public function __toString(): string { return $this->toString(); } /** * @return string[] */ public function jsonSerialize(): array { return [ 'seconds' => $this->getSeconds()->toString(), 'microseconds' => $this->getMicroseconds()->toString(), ]; } public function serialize(): string { return (string) json_encode($this); } /** * @return array{seconds: string, microseconds: string} */ public function __serialize(): array { return [ 'seconds' => $this->getSeconds()->toString(), 'microseconds' => $this->getMicroseconds()->toString(), ]; } /** * Constructs the object from a serialized string representation * * @param string $data The serialized string representation of the object * * @psalm-suppress UnusedMethodCall */ public function unserialize(string $data): void { /** @var array{seconds?: int|float|string, microseconds?: int|float|string} $time */ $time = json_decode($data, true); if (!isset($time['seconds']) || !isset($time['microseconds'])) { throw new UnsupportedOperationException( 'Attempted to unserialize an invalid value' ); } $this->__construct($time['seconds'], $time['microseconds']); } /** * @param array{seconds?: string, microseconds?: string} $data */ public function __unserialize(array $data): void { // @codeCoverageIgnoreStart if (!isset($data['seconds']) || !isset($data['microseconds'])) { throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__)); } // @codeCoverageIgnoreEnd $this->__construct($data['seconds'], $data['microseconds']); } } PK ! _~�P# # Type/Integer.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Type; use Ramsey\Uuid\Exception\InvalidArgumentException; use ValueError; use function assert; use function is_numeric; use function preg_match; use function sprintf; use function substr; /** * A value object representing an integer * * This class exists for type-safety purposes, to ensure that integers * returned from ramsey/uuid methods as strings are truly integers and not some * other kind of string. * * To support large integers beyond PHP_INT_MAX and PHP_INT_MIN on both 64-bit * and 32-bit systems, we store the integers as strings. * * @psalm-immutable */ final class Integer implements NumberInterface { /** * @psalm-var numeric-string */ private string $value; private bool $isNegative = false; public function __construct(float | int | string | self $value) { $this->value = $value instanceof self ? (string) $value : $this->prepareValue($value); } public function isNegative(): bool { return $this->isNegative; } /** * @psalm-return numeric-string */ public function toString(): string { return $this->value; } /** * @psalm-return numeric-string */ public function __toString(): string { return $this->toString(); } public function jsonSerialize(): string { return $this->toString(); } public function serialize(): string { return $this->toString(); } /** * @return array{string: string} */ public function __serialize(): array { return ['string' => $this->toString()]; } /** * Constructs the object from a serialized string representation * * @param string $data The serialized string representation of the object * * @psalm-suppress UnusedMethodCall */ public function unserialize(string $data): void { $this->__construct($data); } /** * @param array{string?: string} $data */ public function __unserialize(array $data): void { // @codeCoverageIgnoreStart if (!isset($data['string'])) { throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__)); } // @codeCoverageIgnoreEnd $this->unserialize($data['string']); } /** * @return numeric-string */ private function prepareValue(float | int | string $value): string { $value = (string) $value; $sign = '+'; // If the value contains a sign, remove it for digit pattern check. if (str_starts_with($value, '-') || str_starts_with($value, '+')) { $sign = substr($value, 0, 1); $value = substr($value, 1); } if (!preg_match('/^\d+$/', $value)) { throw new InvalidArgumentException( 'Value must be a signed integer or a string containing only ' . 'digits 0-9 and, optionally, a sign (+ or -)' ); } // Trim any leading zeros. $value = ltrim($value, '0'); // Set to zero if the string is empty after trimming zeros. if ($value === '') { $value = '0'; } // Add the negative sign back to the value. if ($sign === '-' && $value !== '0') { $value = $sign . $value; /** @psalm-suppress InaccessibleProperty */ $this->isNegative = true; } assert(is_numeric($value)); return $value; } } PK ! {ޕ � Type/TypeInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Type; use JsonSerializable; use Serializable; /** * TypeInterface ensures consistency in typed values returned by ramsey/uuid * * @psalm-immutable */ interface TypeInterface extends JsonSerializable, Serializable { public function toString(): string; public function __toString(): string; } PK ! �4+ + Type/Decimal.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Type; use Ramsey\Uuid\Exception\InvalidArgumentException; use ValueError; use function is_numeric; use function sprintf; use function str_starts_with; /** * A value object representing a decimal * * This class exists for type-safety purposes, to ensure that decimals * returned from ramsey/uuid methods as strings are truly decimals and not some * other kind of string. * * To support values as true decimals and not as floats or doubles, we store the * decimals as strings. * * @psalm-immutable */ final class Decimal implements NumberInterface { private string $value; private bool $isNegative = false; public function __construct(float | int | string | self $value) { $value = (string) $value; if (!is_numeric($value)) { throw new InvalidArgumentException( 'Value must be a signed decimal or a string containing only ' . 'digits 0-9 and, optionally, a decimal point or sign (+ or -)' ); } // Remove the leading +-symbol. if (str_starts_with($value, '+')) { $value = substr($value, 1); } // For cases like `-0` or `-0.0000`, convert the value to `0`. if (abs((float) $value) === 0.0) { $value = '0'; } if (str_starts_with($value, '-')) { $this->isNegative = true; } $this->value = $value; } public function isNegative(): bool { return $this->isNegative; } public function toString(): string { return $this->value; } public function __toString(): string { return $this->toString(); } public function jsonSerialize(): string { return $this->toString(); } public function serialize(): string { return $this->toString(); } /** * @return array{string: string} */ public function __serialize(): array { return ['string' => $this->toString()]; } /** * Constructs the object from a serialized string representation * * @param string $data The serialized string representation of the object * * @psalm-suppress UnusedMethodCall */ public function unserialize(string $data): void { $this->__construct($data); } /** * @param array{string?: string} $data * * @psalm-suppress UnusedMethodCall */ public function __unserialize(array $data): void { // @codeCoverageIgnoreStart if (!isset($data['string'])) { throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__)); } // @codeCoverageIgnoreEnd $this->unserialize($data['string']); } } PK ! ����{ { Type/NumberInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Type; /** * NumberInterface ensures consistency in numeric values returned by ramsey/uuid * * @psalm-immutable */ interface NumberInterface extends TypeInterface { /** * Returns true if this number is less than zero */ public function isNegative(): bool; } PK ! '�&�x x " Generator/RandomBytesGenerator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use Ramsey\Uuid\Exception\RandomSourceException; use Throwable; /** * RandomBytesGenerator generates strings of random binary data using the * built-in `random_bytes()` PHP function * * @link http://php.net/random_bytes random_bytes() */ class RandomBytesGenerator implements RandomGeneratorInterface { /** * @throws RandomSourceException if random_bytes() throws an exception/error * * @inheritDoc */ public function generate(int $length): string { try { return random_bytes($length); } catch (Throwable $exception) { throw new RandomSourceException( $exception->getMessage(), (int) $exception->getCode(), $exception ); } } } PK ! ��i i # Generator/PeclUuidTimeGenerator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use function uuid_create; use function uuid_parse; use const UUID_TYPE_TIME; /** * PeclUuidTimeGenerator generates strings of binary data for time-base UUIDs, * using ext-uuid * * @link https://pecl.php.net/package/uuid ext-uuid */ class PeclUuidTimeGenerator implements TimeGeneratorInterface { /** * @inheritDoc */ public function generate($node = null, ?int $clockSeq = null): string { $uuid = uuid_create(UUID_TYPE_TIME); return uuid_parse($uuid); } } PK ! �N�� � " Generator/DefaultNameGenerator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use Ramsey\Uuid\Exception\NameException; use Ramsey\Uuid\UuidInterface; use ValueError; use function hash; /** * DefaultNameGenerator generates strings of binary data based on a namespace, * name, and hashing algorithm */ class DefaultNameGenerator implements NameGeneratorInterface { /** @psalm-pure */ public function generate(UuidInterface $ns, string $name, string $hashAlgorithm): string { try { /** @var string|bool $bytes */ $bytes = @hash($hashAlgorithm, $ns->getBytes() . $name, true); } catch (ValueError $e) { $bytes = false; // keep same behavior than PHP 7 } if ($bytes === false) { throw new NameException(sprintf( 'Unable to hash namespace and name with algorithm \'%s\'', $hashAlgorithm )); } return (string) $bytes; } } PK ! R��H H # Generator/PeclUuidNameGenerator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use Ramsey\Uuid\Exception\NameException; use Ramsey\Uuid\UuidInterface; use function sprintf; use function uuid_generate_md5; use function uuid_generate_sha1; use function uuid_parse; /** * PeclUuidNameGenerator generates strings of binary data from a namespace and a * name, using ext-uuid * * @link https://pecl.php.net/package/uuid ext-uuid */ class PeclUuidNameGenerator implements NameGeneratorInterface { /** @psalm-pure */ public function generate(UuidInterface $ns, string $name, string $hashAlgorithm): string { $uuid = match ($hashAlgorithm) { 'md5' => uuid_generate_md5($ns->toString(), $name), 'sha1' => uuid_generate_sha1($ns->toString(), $name), default => throw new NameException( sprintf( 'Unable to hash namespace and name with algorithm \'%s\'', $hashAlgorithm ) ), }; return uuid_parse($uuid); } } PK ! p�U U Generator/UnixTimeGenerator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use Brick\Math\BigInteger; use DateTimeImmutable; use DateTimeInterface; use Ramsey\Uuid\Type\Hexadecimal; use function hash; use function pack; use function str_pad; use function strlen; use function substr; use function substr_replace; use function unpack; use const PHP_INT_SIZE; use const STR_PAD_LEFT; /** * UnixTimeGenerator generates bytes that combine a 48-bit timestamp in * milliseconds since the Unix Epoch with 80 random bits * * Code and concepts within this class are borrowed from the symfony/uid package * and are used under the terms of the MIT license distributed with symfony/uid. * * symfony/uid is copyright (c) Fabien Potencier. * * @link https://symfony.com/components/Uid Symfony Uid component * @link https://github.com/symfony/uid/blob/4f9f537e57261519808a7ce1d941490736522bbc/UuidV7.php Symfony UuidV7 class * @link https://github.com/symfony/uid/blob/6.2/LICENSE MIT License */ class UnixTimeGenerator implements TimeGeneratorInterface { private static string $time = ''; private static ?string $seed = null; private static int $seedIndex = 0; /** @var int[] */ private static array $rand = []; /** @var int[] */ private static array $seedParts; public function __construct( private RandomGeneratorInterface $randomGenerator, private int $intSize = PHP_INT_SIZE ) { } /** * @param Hexadecimal|int|string|null $node Unused in this generator * @param int|null $clockSeq Unused in this generator * @param DateTimeInterface $dateTime A date-time instance to use when * generating bytes * * @inheritDoc */ public function generate($node = null, ?int $clockSeq = null, ?DateTimeInterface $dateTime = null): string { $time = ($dateTime ?? new DateTimeImmutable('now'))->format('Uv'); if ($time > self::$time || ($dateTime !== null && $time !== self::$time)) { $this->randomize($time); } else { $time = $this->increment(); } if ($this->intSize >= 8) { $time = substr(pack('J', (int) $time), -6); } else { $time = str_pad(BigInteger::of($time)->toBytes(false), 6, "\x00", STR_PAD_LEFT); } /** @var non-empty-string */ return $time . pack('n*', self::$rand[1], self::$rand[2], self::$rand[3], self::$rand[4], self::$rand[5]); } private function randomize(string $time): void { if (self::$seed === null) { $seed = $this->randomGenerator->generate(16); self::$seed = $seed; } else { $seed = $this->randomGenerator->generate(10); } /** @var int[] $rand */ $rand = unpack('n*', $seed); $rand[1] &= 0x03ff; self::$rand = $rand; self::$time = $time; } /** * Special thanks to Nicolas Grekas for sharing the following information: * * Within the same ms, we increment the rand part by a random 24-bit number. * * Instead of getting this number from random_bytes(), which is slow, we get * it by sha512-hashing self::$seed. This produces 64 bytes of entropy, * which we need to split in a list of 24-bit numbers. unpack() first splits * them into 16 x 32-bit numbers; we take the first byte of each of these * numbers to get 5 extra 24-bit numbers. Then, we consume those numbers * one-by-one and run this logic every 21 iterations. * * self::$rand holds the random part of the UUID, split into 5 x 16-bit * numbers for x86 portability. We increment this random part by the next * 24-bit number in the self::$seedParts list and decrement * self::$seedIndex. * * @link https://twitter.com/nicolasgrekas/status/1583356938825261061 Tweet from Nicolas Grekas */ private function increment(): string { if (self::$seedIndex === 0 && self::$seed !== null) { self::$seed = hash('sha512', self::$seed, true); /** @var int[] $s */ $s = unpack('l*', self::$seed); $s[] = ($s[1] >> 8 & 0xff0000) | ($s[2] >> 16 & 0xff00) | ($s[3] >> 24 & 0xff); $s[] = ($s[4] >> 8 & 0xff0000) | ($s[5] >> 16 & 0xff00) | ($s[6] >> 24 & 0xff); $s[] = ($s[7] >> 8 & 0xff0000) | ($s[8] >> 16 & 0xff00) | ($s[9] >> 24 & 0xff); $s[] = ($s[10] >> 8 & 0xff0000) | ($s[11] >> 16 & 0xff00) | ($s[12] >> 24 & 0xff); $s[] = ($s[13] >> 8 & 0xff0000) | ($s[14] >> 16 & 0xff00) | ($s[15] >> 24 & 0xff); self::$seedParts = $s; self::$seedIndex = 21; } self::$rand[5] = 0xffff & $carry = self::$rand[5] + 1 + (self::$seedParts[self::$seedIndex--] & 0xffffff); self::$rand[4] = 0xffff & $carry = self::$rand[4] + ($carry >> 16); self::$rand[3] = 0xffff & $carry = self::$rand[3] + ($carry >> 16); self::$rand[2] = 0xffff & $carry = self::$rand[2] + ($carry >> 16); self::$rand[1] += $carry >> 16; if (0xfc00 & self::$rand[1]) { $time = self::$time; $mtime = (int) substr($time, -9); if ($this->intSize >= 8 || strlen($time) < 10) { $time = (string) ((int) $time + 1); } elseif ($mtime === 999999999) { $time = (1 + (int) substr($time, 0, -9)) . '000000000'; } else { $mtime++; $time = substr_replace($time, str_pad((string) $mtime, 9, '0', STR_PAD_LEFT), -9); } $this->randomize($time); } return self::$time; } } PK ! �! � � " Generator/NameGeneratorFactory.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; /** * NameGeneratorFactory retrieves a default name generator, based on the * environment */ class NameGeneratorFactory { /** * Returns a default name generator, based on the current environment */ public function getGenerator(): NameGeneratorInterface { return new DefaultNameGenerator(); } } PK ! ����� � " Generator/TimeGeneratorFactory.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Provider\NodeProviderInterface; use Ramsey\Uuid\Provider\TimeProviderInterface; /** * TimeGeneratorFactory retrieves a default time generator, based on the * environment */ class TimeGeneratorFactory { public function __construct( private NodeProviderInterface $nodeProvider, private TimeConverterInterface $timeConverter, private TimeProviderInterface $timeProvider ) { } /** * Returns a default time generator, based on the current environment */ public function getGenerator(): TimeGeneratorInterface { return new DefaultTimeGenerator( $this->nodeProvider, $this->timeConverter, $this->timeProvider ); } } PK ! J���� � $ Generator/RandomGeneratorFactory.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; /** * RandomGeneratorFactory retrieves a default random generator, based on the * environment */ class RandomGeneratorFactory { /** * Returns a default random generator, based on the current environment */ public function getGenerator(): RandomGeneratorInterface { return new RandomBytesGenerator(); } } PK ! ���h3 3 " Generator/DefaultTimeGenerator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Exception\RandomSourceException; use Ramsey\Uuid\Exception\TimeSourceException; use Ramsey\Uuid\Provider\NodeProviderInterface; use Ramsey\Uuid\Provider\TimeProviderInterface; use Ramsey\Uuid\Type\Hexadecimal; use Throwable; use function dechex; use function hex2bin; use function is_int; use function pack; use function preg_match; use function sprintf; use function str_pad; use function strlen; use const STR_PAD_LEFT; /** * DefaultTimeGenerator generates strings of binary data based on a node ID, * clock sequence, and the current time */ class DefaultTimeGenerator implements TimeGeneratorInterface { public function __construct( private NodeProviderInterface $nodeProvider, private TimeConverterInterface $timeConverter, private TimeProviderInterface $timeProvider ) { } /** * @throws InvalidArgumentException if the parameters contain invalid values * @throws RandomSourceException if random_int() throws an exception/error * * @inheritDoc */ public function generate($node = null, ?int $clockSeq = null): string { if ($node instanceof Hexadecimal) { $node = $node->toString(); } $node = $this->getValidNode($node); if ($clockSeq === null) { try { // This does not use "stable storage"; see RFC 4122, Section 4.2.1.1. $clockSeq = random_int(0, 0x3fff); } catch (Throwable $exception) { throw new RandomSourceException( $exception->getMessage(), (int) $exception->getCode(), $exception ); } } $time = $this->timeProvider->getTime(); $uuidTime = $this->timeConverter->calculateTime( $time->getSeconds()->toString(), $time->getMicroseconds()->toString() ); $timeHex = str_pad($uuidTime->toString(), 16, '0', STR_PAD_LEFT); if (strlen($timeHex) !== 16) { throw new TimeSourceException(sprintf( 'The generated time of \'%s\' is larger than expected', $timeHex )); } $timeBytes = (string) hex2bin($timeHex); return $timeBytes[4] . $timeBytes[5] . $timeBytes[6] . $timeBytes[7] . $timeBytes[2] . $timeBytes[3] . $timeBytes[0] . $timeBytes[1] . pack('n*', $clockSeq) . $node; } /** * Uses the node provider given when constructing this instance to get * the node ID (usually a MAC address) * * @param int|string|null $node A node value that may be used to override the node provider * * @return string 6-byte binary string representation of the node * * @throws InvalidArgumentException */ private function getValidNode(int | string | null $node): string { if ($node === null) { $node = $this->nodeProvider->getNode(); } // Convert the node to hex, if it is still an integer. if (is_int($node)) { $node = dechex($node); } if (!preg_match('/^[A-Fa-f0-9]+$/', (string) $node) || strlen((string) $node) > 12) { throw new InvalidArgumentException('Invalid node value'); } return (string) hex2bin(str_pad((string) $node, 12, '0', STR_PAD_LEFT)); } } PK ! �m$� � & Generator/RandomGeneratorInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; /** * A random generator generates strings of random binary data */ interface RandomGeneratorInterface { /** * Generates a string of randomized binary data * * @param int<1, max> $length The number of bytes of random binary data to generate * * @return string A binary string */ public function generate(int $length): string; } PK ! q��' ' % Generator/PeclUuidRandomGenerator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use function uuid_create; use function uuid_parse; use const UUID_TYPE_RANDOM; /** * PeclUuidRandomGenerator generates strings of random binary data using ext-uuid * * @link https://pecl.php.net/package/uuid ext-uuid */ class PeclUuidRandomGenerator implements RandomGeneratorInterface { public function generate(int $length): string { $uuid = uuid_create(UUID_TYPE_RANDOM); return uuid_parse($uuid); } } PK ! B��x� � $ Generator/TimeGeneratorInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use Ramsey\Uuid\Type\Hexadecimal; /** * A time generator generates strings of binary data based on a node ID, * clock sequence, and the current time */ interface TimeGeneratorInterface { /** * Generate a binary string from a node ID, clock sequence, and current time * * @param Hexadecimal|int|string|null $node A 48-bit number representing the * hardware address; this number may be represented as an integer or a * hexadecimal string * @param int|null $clockSeq A 14-bit number used to help avoid duplicates * that could arise when the clock is set backwards in time or if the * node ID changes * * @return string A binary string */ public function generate($node = null, ?int $clockSeq = null): string; } PK ! ��(` ` " Generator/DceSecurityGenerator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Exception\DceSecurityException; use Ramsey\Uuid\Provider\DceSecurityProviderInterface; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; use Ramsey\Uuid\Uuid; use function hex2bin; use function in_array; use function pack; use function str_pad; use function strlen; use function substr_replace; use const STR_PAD_LEFT; /** * DceSecurityGenerator generates strings of binary data based on a local * domain, local identifier, node ID, clock sequence, and the current time */ class DceSecurityGenerator implements DceSecurityGeneratorInterface { private const DOMAINS = [ Uuid::DCE_DOMAIN_PERSON, Uuid::DCE_DOMAIN_GROUP, Uuid::DCE_DOMAIN_ORG, ]; /** * Upper bounds for the clock sequence in DCE Security UUIDs. */ private const CLOCK_SEQ_HIGH = 63; /** * Lower bounds for the clock sequence in DCE Security UUIDs. */ private const CLOCK_SEQ_LOW = 0; public function __construct( private NumberConverterInterface $numberConverter, private TimeGeneratorInterface $timeGenerator, private DceSecurityProviderInterface $dceSecurityProvider ) { } public function generate( int $localDomain, ?IntegerObject $localIdentifier = null, ?Hexadecimal $node = null, ?int $clockSeq = null ): string { if (!in_array($localDomain, self::DOMAINS)) { throw new DceSecurityException( 'Local domain must be a valid DCE Security domain' ); } if ($localIdentifier && $localIdentifier->isNegative()) { throw new DceSecurityException( 'Local identifier out of bounds; it must be a value between 0 and 4294967295' ); } if ($clockSeq > self::CLOCK_SEQ_HIGH || $clockSeq < self::CLOCK_SEQ_LOW) { throw new DceSecurityException( 'Clock sequence out of bounds; it must be a value between 0 and 63' ); } switch ($localDomain) { case Uuid::DCE_DOMAIN_ORG: if ($localIdentifier === null) { throw new DceSecurityException( 'A local identifier must be provided for the org domain' ); } break; case Uuid::DCE_DOMAIN_PERSON: if ($localIdentifier === null) { $localIdentifier = $this->dceSecurityProvider->getUid(); } break; case Uuid::DCE_DOMAIN_GROUP: default: if ($localIdentifier === null) { $localIdentifier = $this->dceSecurityProvider->getGid(); } break; } $identifierHex = $this->numberConverter->toHex($localIdentifier->toString()); // The maximum value for the local identifier is 0xffffffff, or // 4294967295. This is 8 hexadecimal digits, so if the length of // hexadecimal digits is greater than 8, we know the value is greater // than 0xffffffff. if (strlen($identifierHex) > 8) { throw new DceSecurityException( 'Local identifier out of bounds; it must be a value between 0 and 4294967295' ); } $domainByte = pack('n', $localDomain)[1]; $identifierBytes = (string) hex2bin(str_pad($identifierHex, 8, '0', STR_PAD_LEFT)); if ($node instanceof Hexadecimal) { $node = $node->toString(); } // Shift the clock sequence 8 bits to the left, so it matches 0x3f00. if ($clockSeq !== null) { $clockSeq = $clockSeq << 8; } $bytes = $this->timeGenerator->generate($node, $clockSeq); // Replace bytes in the time-based UUID with DCE Security values. $bytes = substr_replace($bytes, $identifierBytes, 0, 4); return substr_replace($bytes, $domainByte, 9, 1); } } PK ! ��� � + Generator/DceSecurityGeneratorInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use Ramsey\Uuid\Rfc4122\UuidV2; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; /** * A DCE Security generator generates strings of binary data based on a local * domain, local identifier, node ID, clock sequence, and the current time * * @see UuidV2 */ interface DceSecurityGeneratorInterface { /** * Generate a binary string from a local domain, local identifier, node ID, * clock sequence, and current time * * @param int $localDomain The local domain to use when generating bytes, * according to DCE Security * @param IntegerObject|null $localIdentifier The local identifier for the * given domain; this may be a UID or GID on POSIX systems, if the local * domain is person or group, or it may be a site-defined identifier * if the local domain is org * @param Hexadecimal|null $node A 48-bit number representing the hardware * address * @param int|null $clockSeq A 14-bit number used to help avoid duplicates * that could arise when the clock is set backwards in time or if the * node ID changes * * @return string A binary string */ public function generate( int $localDomain, ?IntegerObject $localIdentifier = null, ?Hexadecimal $node = null, ?int $clockSeq = null ): string; } PK ! �s�* * $ Generator/NameGeneratorInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use Ramsey\Uuid\UuidInterface; /** * A name generator generates strings of binary data created by hashing together * a namespace with a name, according to a hashing algorithm */ interface NameGeneratorInterface { /** * Generate a binary string from a namespace and name hashed together with * the specified hashing algorithm * * @param UuidInterface $ns The namespace * @param string $name The name to use for creating a UUID * @param string $hashAlgorithm The hashing algorithm to use * * @return string A binary string * * @psalm-pure */ public function generate(UuidInterface $ns, string $name, string $hashAlgorithm): string; } PK ! UGa{ { Generator/CombGenerator.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Exception\InvalidArgumentException; use function bin2hex; use function explode; use function hex2bin; use function microtime; use function str_pad; use function substr; use const STR_PAD_LEFT; /** * CombGenerator generates COMBs (combined UUID/timestamp) * * The CombGenerator, when used with the StringCodec (and, by proxy, the * TimestampLastCombCodec) or the TimestampFirstCombCodec, combines the current * timestamp with a UUID (hence the name "COMB"). The timestamp either appears * as the first or last 48 bits of the COMB, depending on the codec used. * * By default, COMBs will have the timestamp set as the last 48 bits of the * identifier. * * ``` php * $factory = new UuidFactory(); * * $factory->setRandomGenerator(new CombGenerator( * $factory->getRandomGenerator(), * $factory->getNumberConverter() * )); * * $comb = $factory->uuid4(); * ``` * * To generate a COMB with the timestamp as the first 48 bits, set the * TimestampFirstCombCodec as the codec. * * ``` php * $factory->setCodec(new TimestampFirstCombCodec($factory->getUuidBuilder())); * ``` * * @link https://www.informit.com/articles/printerfriendly/25862 The Cost of GUIDs as Primary Keys */ class CombGenerator implements RandomGeneratorInterface { public const TIMESTAMP_BYTES = 6; public function __construct( private RandomGeneratorInterface $generator, private NumberConverterInterface $numberConverter ) { } /** * @throws InvalidArgumentException if $length is not a positive integer * greater than or equal to CombGenerator::TIMESTAMP_BYTES * * @inheritDoc */ public function generate(int $length): string { if ($length < self::TIMESTAMP_BYTES) { throw new InvalidArgumentException( 'Length must be a positive integer greater than or equal to ' . self::TIMESTAMP_BYTES ); } $hash = ''; if (self::TIMESTAMP_BYTES > 0 && $length > self::TIMESTAMP_BYTES) { $hash = $this->generator->generate($length - self::TIMESTAMP_BYTES); } $lsbTime = str_pad( $this->numberConverter->toHex($this->timestamp()), self::TIMESTAMP_BYTES * 2, '0', STR_PAD_LEFT ); return (string) hex2bin( str_pad( bin2hex($hash), $length - self::TIMESTAMP_BYTES, '0' ) . $lsbTime ); } /** * Returns current timestamp a string integer, precise to 0.00001 seconds */ private function timestamp(): string { $time = explode(' ', microtime(false)); return $time[1] . substr($time[0], 2, 5); } } PK ! �QJ Generator/RandomLibAdapter.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Generator; use RandomLib\Factory; use RandomLib\Generator; /** * RandomLibAdapter generates strings of random binary data using the * paragonie/random-lib library * * @deprecated This class will be removed in 5.0.0. Use the default * RandomBytesGenerator or implement your own generator that implements * RandomGeneratorInterface. * * @link https://packagist.org/packages/paragonie/random-lib paragonie/random-lib */ class RandomLibAdapter implements RandomGeneratorInterface { private Generator $generator; /** * Constructs a RandomLibAdapter * * By default, if no Generator is passed in, this creates a high-strength * generator to use when generating random binary data. * * @param Generator|null $generator The generator to use when generating binary data */ public function __construct(?Generator $generator = null) { if ($generator === null) { $factory = new Factory(); $generator = $factory->getHighStrengthGenerator(); } $this->generator = $generator; } public function generate(int $length): string { return $this->generator->generate($length); } } PK ! Tgd ' Converter/Number/BigNumberConverter.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Converter\Number; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Math\BrickMathCalculator; /** * Previously used to integrate moontoast/math as a bignum arithmetic library, * BigNumberConverter is deprecated in favor of GenericNumberConverter * * @deprecated Transition to {@see GenericNumberConverter}. * * @psalm-immutable */ class BigNumberConverter implements NumberConverterInterface { private NumberConverterInterface $converter; public function __construct() { $this->converter = new GenericNumberConverter(new BrickMathCalculator()); } /** * @inheritDoc * @psalm-pure */ public function fromHex(string $hex): string { return $this->converter->fromHex($hex); } /** * @inheritDoc * @psalm-pure */ public function toHex(string $number): string { return $this->converter->toHex($number); } } PK ! �vW�n n , Converter/Number/DegradedNumberConverter.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Converter\Number; /** * @deprecated DegradedNumberConverter is no longer necessary for converting * numbers on 32-bit systems. Transition to {@see GenericNumberConverter}. * * @psalm-immutable */ class DegradedNumberConverter extends BigNumberConverter { } PK ! �Z'�� � + Converter/Number/GenericNumberConverter.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Converter\Number; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Math\CalculatorInterface; use Ramsey\Uuid\Type\Integer as IntegerObject; /** * GenericNumberConverter uses the provided calculator to convert decimal * numbers to and from hexadecimal values * * @psalm-immutable */ class GenericNumberConverter implements NumberConverterInterface { public function __construct(private CalculatorInterface $calculator) { } /** * @inheritDoc * @psalm-pure * @psalm-return numeric-string * @psalm-suppress MoreSpecificReturnType we know that the retrieved `string` is never empty * @psalm-suppress LessSpecificReturnStatement we know that the retrieved `string` is never empty */ public function fromHex(string $hex): string { return $this->calculator->fromBase($hex, 16)->toString(); } /** * @inheritDoc * @psalm-pure * @psalm-return non-empty-string * @psalm-suppress MoreSpecificReturnType we know that the retrieved `string` is never empty * @psalm-suppress LessSpecificReturnStatement we know that the retrieved `string` is never empty */ public function toHex(string $number): string { /** @phpstan-ignore-next-line PHPStan complains that this is not a non-empty-string. */ return $this->calculator->toBase(new IntegerObject($number), 16); } } PK ! [�, , ) Converter/Time/BigNumberTimeConverter.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Converter\Time; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Math\BrickMathCalculator; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Time; /** * Previously used to integrate moontoast/math as a bignum arithmetic library, * BigNumberTimeConverter is deprecated in favor of GenericTimeConverter * * @deprecated Transition to {@see GenericTimeConverter}. * * @psalm-immutable */ class BigNumberTimeConverter implements TimeConverterInterface { private TimeConverterInterface $converter; public function __construct() { $this->converter = new GenericTimeConverter(new BrickMathCalculator()); } public function calculateTime(string $seconds, string $microseconds): Hexadecimal { return $this->converter->calculateTime($seconds, $microseconds); } public function convertTime(Hexadecimal $uuidTimestamp): Time { return $this->converter->convertTime($uuidTimestamp); } } PK ! s�(�g g ( Converter/Time/DegradedTimeConverter.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Converter\Time; /** * @deprecated DegradedTimeConverter is no longer necessary for converting * time on 32-bit systems. Transition to {@see GenericTimeConverter}. * * @psalm-immutable */ class DegradedTimeConverter extends BigNumberTimeConverter { } PK ! V��� � $ Converter/Time/UnixTimeConverter.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Converter\Time; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Math\CalculatorInterface; use Ramsey\Uuid\Math\RoundingMode; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; use Ramsey\Uuid\Type\Time; use function explode; use function str_pad; use const STR_PAD_LEFT; /** * UnixTimeConverter converts Unix Epoch timestamps to/from hexadecimal values * consisting of milliseconds elapsed since the Unix Epoch * * @psalm-immutable */ class UnixTimeConverter implements TimeConverterInterface { private const MILLISECONDS = 1000; public function __construct(private CalculatorInterface $calculator) { } public function calculateTime(string $seconds, string $microseconds): Hexadecimal { $timestamp = new Time($seconds, $microseconds); // Convert the seconds into milliseconds. $sec = $this->calculator->multiply( $timestamp->getSeconds(), new IntegerObject(self::MILLISECONDS), ); // Convert the microseconds into milliseconds; the scale is zero because // we need to discard the fractional part. $usec = $this->calculator->divide( RoundingMode::DOWN, // Always round down to stay in the previous millisecond. 0, $timestamp->getMicroseconds(), new IntegerObject(self::MILLISECONDS), ); /** @var IntegerObject $unixTime */ $unixTime = $this->calculator->add($sec, $usec); $unixTimeHex = str_pad( $this->calculator->toHexadecimal($unixTime)->toString(), 12, '0', STR_PAD_LEFT ); return new Hexadecimal($unixTimeHex); } public function convertTime(Hexadecimal $uuidTimestamp): Time { $milliseconds = $this->calculator->toInteger($uuidTimestamp); $unixTimestamp = $this->calculator->divide( RoundingMode::HALF_UP, 6, $milliseconds, new IntegerObject(self::MILLISECONDS) ); $split = explode('.', (string) $unixTimestamp, 2); return new Time($split[0], $split[1] ?? '0'); } } PK ! ��atw w ' Converter/Time/GenericTimeConverter.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Converter\Time; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Math\CalculatorInterface; use Ramsey\Uuid\Math\RoundingMode; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; use Ramsey\Uuid\Type\Time; use function explode; use function str_pad; use const STR_PAD_LEFT; /** * GenericTimeConverter uses the provided calculator to calculate and convert * time values * * @psalm-immutable */ class GenericTimeConverter implements TimeConverterInterface { /** * The number of 100-nanosecond intervals from the Gregorian calendar epoch * to the Unix epoch. */ private const GREGORIAN_TO_UNIX_INTERVALS = '122192928000000000'; /** * The number of 100-nanosecond intervals in one second. */ private const SECOND_INTERVALS = '10000000'; /** * The number of 100-nanosecond intervals in one microsecond. */ private const MICROSECOND_INTERVALS = '10'; public function __construct(private CalculatorInterface $calculator) { } public function calculateTime(string $seconds, string $microseconds): Hexadecimal { $timestamp = new Time($seconds, $microseconds); // Convert the seconds into a count of 100-nanosecond intervals. $sec = $this->calculator->multiply( $timestamp->getSeconds(), new IntegerObject(self::SECOND_INTERVALS) ); // Convert the microseconds into a count of 100-nanosecond intervals. $usec = $this->calculator->multiply( $timestamp->getMicroseconds(), new IntegerObject(self::MICROSECOND_INTERVALS) ); // Combine the seconds and microseconds intervals and add the count of // 100-nanosecond intervals from the Gregorian calendar epoch to the // Unix epoch. This gives us the correct count of 100-nanosecond // intervals since the Gregorian calendar epoch for the given seconds // and microseconds. /** @var IntegerObject $uuidTime */ $uuidTime = $this->calculator->add( $sec, $usec, new IntegerObject(self::GREGORIAN_TO_UNIX_INTERVALS) ); $uuidTimeHex = str_pad( $this->calculator->toHexadecimal($uuidTime)->toString(), 16, '0', STR_PAD_LEFT ); return new Hexadecimal($uuidTimeHex); } public function convertTime(Hexadecimal $uuidTimestamp): Time { // From the total, subtract the number of 100-nanosecond intervals from // the Gregorian calendar epoch to the Unix epoch. This gives us the // number of 100-nanosecond intervals from the Unix epoch, which also // includes the microtime. $epochNanoseconds = $this->calculator->subtract( $this->calculator->toInteger($uuidTimestamp), new IntegerObject(self::GREGORIAN_TO_UNIX_INTERVALS) ); // Convert the 100-nanosecond intervals into seconds and microseconds. $unixTimestamp = $this->calculator->divide( RoundingMode::HALF_UP, 6, $epochNanoseconds, new IntegerObject(self::SECOND_INTERVALS) ); $split = explode('.', (string) $unixTimestamp, 2); return new Time($split[0], $split[1] ?? 0); } } PK ! Xz�� � # Converter/Time/PhpTimeConverter.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Converter\Time; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Math\BrickMathCalculator; use Ramsey\Uuid\Math\CalculatorInterface; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; use Ramsey\Uuid\Type\Time; use function count; use function dechex; use function explode; use function is_float; use function is_int; use function str_pad; use function strlen; use function substr; use const STR_PAD_LEFT; use const STR_PAD_RIGHT; /** * PhpTimeConverter uses built-in PHP functions and standard math operations * available to the PHP programming language to provide facilities for * converting parts of time into representations that may be used in UUIDs * * @psalm-immutable */ class PhpTimeConverter implements TimeConverterInterface { /** * The number of 100-nanosecond intervals from the Gregorian calendar epoch * to the Unix epoch. */ private const GREGORIAN_TO_UNIX_INTERVALS = 0x01b21dd213814000; /** * The number of 100-nanosecond intervals in one second. */ private const SECOND_INTERVALS = 10000000; /** * The number of 100-nanosecond intervals in one microsecond. */ private const MICROSECOND_INTERVALS = 10; private int $phpPrecision; private CalculatorInterface $calculator; private TimeConverterInterface $fallbackConverter; public function __construct( ?CalculatorInterface $calculator = null, ?TimeConverterInterface $fallbackConverter = null ) { if ($calculator === null) { $calculator = new BrickMathCalculator(); } if ($fallbackConverter === null) { $fallbackConverter = new GenericTimeConverter($calculator); } $this->calculator = $calculator; $this->fallbackConverter = $fallbackConverter; $this->phpPrecision = (int) ini_get('precision'); } public function calculateTime(string $seconds, string $microseconds): Hexadecimal { $seconds = new IntegerObject($seconds); $microseconds = new IntegerObject($microseconds); // Calculate the count of 100-nanosecond intervals since the Gregorian // calendar epoch for the given seconds and microseconds. $uuidTime = ((int) $seconds->toString() * self::SECOND_INTERVALS) + ((int) $microseconds->toString() * self::MICROSECOND_INTERVALS) + self::GREGORIAN_TO_UNIX_INTERVALS; // Check to see whether we've overflowed the max/min integer size. // If so, we will default to a different time converter. /** @psalm-suppress RedundantCondition */ if (!is_int($uuidTime)) { return $this->fallbackConverter->calculateTime( $seconds->toString(), $microseconds->toString() ); } return new Hexadecimal(str_pad(dechex($uuidTime), 16, '0', STR_PAD_LEFT)); } public function convertTime(Hexadecimal $uuidTimestamp): Time { $timestamp = $this->calculator->toInteger($uuidTimestamp); // Convert the 100-nanosecond intervals into seconds and microseconds. $splitTime = $this->splitTime( ((int) $timestamp->toString() - self::GREGORIAN_TO_UNIX_INTERVALS) / self::SECOND_INTERVALS ); if (count($splitTime) === 0) { return $this->fallbackConverter->convertTime($uuidTimestamp); } return new Time($splitTime['sec'], $splitTime['usec']); } /** * @param float|int $time The time to split into seconds and microseconds * * @return string[] */ private function splitTime(float | int $time): array { $split = explode('.', (string) $time, 2); // If the $time value is a float but $split only has 1 element, then the // float math was rounded up to the next second, so we want to return // an empty array to allow use of the fallback converter. if (is_float($time) && count($split) === 1) { return []; } if (count($split) === 1) { return [ 'sec' => $split[0], 'usec' => '0', ]; } // If the microseconds are less than six characters AND the length of // the number is greater than or equal to the PHP precision, then it's // possible that we lost some precision for the microseconds. Return an // empty array, so that we can choose to use the fallback converter. if (strlen($split[1]) < 6 && strlen((string) $time) >= $this->phpPrecision) { return []; } $microseconds = $split[1]; // Ensure the microseconds are no longer than 6 digits. If they are, // truncate the number to the first 6 digits and round up, if needed. if (strlen($microseconds) > 6) { $roundingDigit = (int) substr($microseconds, 6, 1); $microseconds = (int) substr($microseconds, 0, 6); if ($roundingDigit >= 5) { $microseconds++; } } return [ 'sec' => $split[0], 'usec' => str_pad((string) $microseconds, 6, '0', STR_PAD_RIGHT), ]; } } PK ! �ix $ Converter/TimeConverterInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Converter; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Time; /** * A time converter converts timestamps into representations that may be used * in UUIDs * * @psalm-immutable */ interface TimeConverterInterface { /** * Uses the provided seconds and micro-seconds to calculate the count of * 100-nanosecond intervals since UTC 00:00:00.00, 15 October 1582, for * RFC 4122 variant UUIDs * * @link http://tools.ietf.org/html/rfc4122#section-4.2.2 RFC 4122, § 4.2.2: Generation Details * * @param string $seconds A string representation of the number of seconds * since the Unix epoch for the time to calculate * @param string $microseconds A string representation of the micro-seconds * associated with the time to calculate * * @return Hexadecimal The full UUID timestamp as a Hexadecimal value * * @psalm-pure */ public function calculateTime(string $seconds, string $microseconds): Hexadecimal; /** * Converts a timestamp extracted from a UUID to a Unix timestamp * * @param Hexadecimal $uuidTimestamp A hexadecimal representation of a UUID * timestamp; a UUID timestamp is a count of 100-nanosecond intervals * since UTC 00:00:00.00, 15 October 1582. * * @return Time An instance of {@see Time} * * @psalm-pure */ public function convertTime(Hexadecimal $uuidTimestamp): Time; } PK ! �ja* * & Converter/NumberConverterInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Converter; /** * A number converter converts UUIDs from hexadecimal characters into * representations of integers and vice versa * * @psalm-immutable */ interface NumberConverterInterface { /** * Converts a hexadecimal number into an string integer representation of * the number * * The integer representation returned is a string representation of the * integer, to accommodate unsigned integers greater than PHP_INT_MAX. * * @param string $hex The hexadecimal string representation to convert * * @return string String representation of an integer * * @psalm-return numeric-string * * @psalm-pure */ public function fromHex(string $hex): string; /** * Converts a string integer representation into a hexadecimal string * representation of the number * * @param string $number A string integer representation to convert; this * must be a numeric string to accommodate unsigned integers greater * than PHP_INT_MAX. * * @return string Hexadecimal string * * @psalm-return non-empty-string * * @psalm-pure */ public function toHex(string $number): string; } PK ! t�4� � Fields/FieldsInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Fields; use Serializable; /** * UUIDs are comprised of unsigned integers, the bytes of which are separated * into fields and arranged in a particular layout defined by the specification * for the variant * * @psalm-immutable */ interface FieldsInterface extends Serializable { /** * Returns the bytes that comprise the fields */ public function getBytes(): string; } PK ! yy��� � " Fields/SerializableFieldsTrait.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Fields; use ValueError; use function base64_decode; use function sprintf; use function strlen; /** * Provides common serialization functionality to fields * * @psalm-immutable */ trait SerializableFieldsTrait { /** * @param string $bytes The bytes that comprise the fields */ abstract public function __construct(string $bytes); /** * Returns the bytes that comprise the fields */ abstract public function getBytes(): string; /** * Returns a string representation of object */ public function serialize(): string { return $this->getBytes(); } /** * @return array{bytes: string} */ public function __serialize(): array { return ['bytes' => $this->getBytes()]; } /** * Constructs the object from a serialized string representation * * @param string $data The serialized string representation of the object * * @psalm-suppress UnusedMethodCall */ public function unserialize(string $data): void { if (strlen($data) === 16) { $this->__construct($data); } else { $this->__construct(base64_decode($data)); } } /** * @param array{bytes?: string} $data * * @psalm-suppress UnusedMethodCall */ public function __unserialize(array $data): void { // @codeCoverageIgnoreStart if (!isset($data['bytes'])) { throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__)); } // @codeCoverageIgnoreEnd $this->unserialize($data['bytes']); } } PK ! ����0 �0 FeatureSet.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid; use Ramsey\Uuid\Builder\FallbackBuilder; use Ramsey\Uuid\Builder\UuidBuilderInterface; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Codec\GuidStringCodec; use Ramsey\Uuid\Codec\StringCodec; use Ramsey\Uuid\Converter\Number\GenericNumberConverter; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\Time\GenericTimeConverter; use Ramsey\Uuid\Converter\Time\PhpTimeConverter; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Generator\DceSecurityGenerator; use Ramsey\Uuid\Generator\DceSecurityGeneratorInterface; use Ramsey\Uuid\Generator\NameGeneratorFactory; use Ramsey\Uuid\Generator\NameGeneratorInterface; use Ramsey\Uuid\Generator\PeclUuidNameGenerator; use Ramsey\Uuid\Generator\PeclUuidRandomGenerator; use Ramsey\Uuid\Generator\PeclUuidTimeGenerator; use Ramsey\Uuid\Generator\RandomGeneratorFactory; use Ramsey\Uuid\Generator\RandomGeneratorInterface; use Ramsey\Uuid\Generator\TimeGeneratorFactory; use Ramsey\Uuid\Generator\TimeGeneratorInterface; use Ramsey\Uuid\Generator\UnixTimeGenerator; use Ramsey\Uuid\Guid\GuidBuilder; use Ramsey\Uuid\Math\BrickMathCalculator; use Ramsey\Uuid\Math\CalculatorInterface; use Ramsey\Uuid\Nonstandard\UuidBuilder as NonstandardUuidBuilder; use Ramsey\Uuid\Provider\Dce\SystemDceSecurityProvider; use Ramsey\Uuid\Provider\DceSecurityProviderInterface; use Ramsey\Uuid\Provider\Node\FallbackNodeProvider; use Ramsey\Uuid\Provider\Node\RandomNodeProvider; use Ramsey\Uuid\Provider\Node\SystemNodeProvider; use Ramsey\Uuid\Provider\NodeProviderInterface; use Ramsey\Uuid\Provider\Time\SystemTimeProvider; use Ramsey\Uuid\Provider\TimeProviderInterface; use Ramsey\Uuid\Rfc4122\UuidBuilder as Rfc4122UuidBuilder; use Ramsey\Uuid\Validator\GenericValidator; use Ramsey\Uuid\Validator\ValidatorInterface; use const PHP_INT_SIZE; /** * FeatureSet detects and exposes available features in the current environment * * A feature set is used by UuidFactory to determine the available features and * capabilities of the environment. */ class FeatureSet { private ?TimeProviderInterface $timeProvider = null; private CalculatorInterface $calculator; private CodecInterface $codec; private DceSecurityGeneratorInterface $dceSecurityGenerator; private NameGeneratorInterface $nameGenerator; private NodeProviderInterface $nodeProvider; private NumberConverterInterface $numberConverter; private RandomGeneratorInterface $randomGenerator; private TimeConverterInterface $timeConverter; private TimeGeneratorInterface $timeGenerator; private TimeGeneratorInterface $unixTimeGenerator; private UuidBuilderInterface $builder; private ValidatorInterface $validator; /** * @param bool $useGuids True build UUIDs using the GuidStringCodec * @param bool $force32Bit True to force the use of 32-bit functionality * (primarily for testing purposes) * @param bool $forceNoBigNumber (obsolete) * @param bool $ignoreSystemNode True to disable attempts to check for the * system node ID (primarily for testing purposes) * @param bool $enablePecl True to enable the use of the PeclUuidTimeGenerator * to generate version 1 UUIDs */ public function __construct( bool $useGuids = false, private bool $force32Bit = false, bool $forceNoBigNumber = false, private bool $ignoreSystemNode = false, private bool $enablePecl = false ) { $this->randomGenerator = $this->buildRandomGenerator(); $this->setCalculator(new BrickMathCalculator()); $this->builder = $this->buildUuidBuilder($useGuids); $this->codec = $this->buildCodec($useGuids); $this->nodeProvider = $this->buildNodeProvider(); $this->nameGenerator = $this->buildNameGenerator(); $this->setTimeProvider(new SystemTimeProvider()); $this->setDceSecurityProvider(new SystemDceSecurityProvider()); $this->validator = new GenericValidator(); assert($this->timeProvider !== null); $this->unixTimeGenerator = $this->buildUnixTimeGenerator(); } /** * Returns the builder configured for this environment */ public function getBuilder(): UuidBuilderInterface { return $this->builder; } /** * Returns the calculator configured for this environment */ public function getCalculator(): CalculatorInterface { return $this->calculator; } /** * Returns the codec configured for this environment */ public function getCodec(): CodecInterface { return $this->codec; } /** * Returns the DCE Security generator configured for this environment */ public function getDceSecurityGenerator(): DceSecurityGeneratorInterface { return $this->dceSecurityGenerator; } /** * Returns the name generator configured for this environment */ public function getNameGenerator(): NameGeneratorInterface { return $this->nameGenerator; } /** * Returns the node provider configured for this environment */ public function getNodeProvider(): NodeProviderInterface { return $this->nodeProvider; } /** * Returns the number converter configured for this environment */ public function getNumberConverter(): NumberConverterInterface { return $this->numberConverter; } /** * Returns the random generator configured for this environment */ public function getRandomGenerator(): RandomGeneratorInterface { return $this->randomGenerator; } /** * Returns the time converter configured for this environment */ public function getTimeConverter(): TimeConverterInterface { return $this->timeConverter; } /** * Returns the time generator configured for this environment */ public function getTimeGenerator(): TimeGeneratorInterface { return $this->timeGenerator; } /** * Returns the Unix Epoch time generator configured for this environment */ public function getUnixTimeGenerator(): TimeGeneratorInterface { return $this->unixTimeGenerator; } /** * Returns the validator configured for this environment */ public function getValidator(): ValidatorInterface { return $this->validator; } /** * Sets the calculator to use in this environment */ public function setCalculator(CalculatorInterface $calculator): void { $this->calculator = $calculator; $this->numberConverter = $this->buildNumberConverter($calculator); $this->timeConverter = $this->buildTimeConverter($calculator); /** @psalm-suppress RedundantPropertyInitializationCheck */ if (isset($this->timeProvider)) { $this->timeGenerator = $this->buildTimeGenerator($this->timeProvider); } } /** * Sets the DCE Security provider to use in this environment */ public function setDceSecurityProvider(DceSecurityProviderInterface $dceSecurityProvider): void { $this->dceSecurityGenerator = $this->buildDceSecurityGenerator($dceSecurityProvider); } /** * Sets the node provider to use in this environment */ public function setNodeProvider(NodeProviderInterface $nodeProvider): void { $this->nodeProvider = $nodeProvider; if (isset($this->timeProvider)) { $this->timeGenerator = $this->buildTimeGenerator($this->timeProvider); } } /** * Sets the time provider to use in this environment */ public function setTimeProvider(TimeProviderInterface $timeProvider): void { $this->timeProvider = $timeProvider; $this->timeGenerator = $this->buildTimeGenerator($timeProvider); } /** * Set the validator to use in this environment */ public function setValidator(ValidatorInterface $validator): void { $this->validator = $validator; } /** * Returns a codec configured for this environment * * @param bool $useGuids Whether to build UUIDs using the GuidStringCodec */ private function buildCodec(bool $useGuids = false): CodecInterface { if ($useGuids) { return new GuidStringCodec($this->builder); } return new StringCodec($this->builder); } /** * Returns a DCE Security generator configured for this environment */ private function buildDceSecurityGenerator( DceSecurityProviderInterface $dceSecurityProvider ): DceSecurityGeneratorInterface { return new DceSecurityGenerator( $this->numberConverter, $this->timeGenerator, $dceSecurityProvider ); } /** * Returns a node provider configured for this environment */ private function buildNodeProvider(): NodeProviderInterface { if ($this->ignoreSystemNode) { return new RandomNodeProvider(); } return new FallbackNodeProvider([ new SystemNodeProvider(), new RandomNodeProvider(), ]); } /** * Returns a number converter configured for this environment */ private function buildNumberConverter(CalculatorInterface $calculator): NumberConverterInterface { return new GenericNumberConverter($calculator); } /** * Returns a random generator configured for this environment */ private function buildRandomGenerator(): RandomGeneratorInterface { if ($this->enablePecl) { return new PeclUuidRandomGenerator(); } return (new RandomGeneratorFactory())->getGenerator(); } /** * Returns a time generator configured for this environment * * @param TimeProviderInterface $timeProvider The time provider to use with * the time generator */ private function buildTimeGenerator(TimeProviderInterface $timeProvider): TimeGeneratorInterface { if ($this->enablePecl) { return new PeclUuidTimeGenerator(); } return (new TimeGeneratorFactory( $this->nodeProvider, $this->timeConverter, $timeProvider ))->getGenerator(); } /** * Returns a Unix Epoch time generator configured for this environment */ private function buildUnixTimeGenerator(): TimeGeneratorInterface { return new UnixTimeGenerator($this->randomGenerator); } /** * Returns a name generator configured for this environment */ private function buildNameGenerator(): NameGeneratorInterface { if ($this->enablePecl) { return new PeclUuidNameGenerator(); } return (new NameGeneratorFactory())->getGenerator(); } /** * Returns a time converter configured for this environment */ private function buildTimeConverter(CalculatorInterface $calculator): TimeConverterInterface { $genericConverter = new GenericTimeConverter($calculator); if ($this->is64BitSystem()) { return new PhpTimeConverter($calculator, $genericConverter); } return $genericConverter; } /** * Returns a UUID builder configured for this environment * * @param bool $useGuids Whether to build UUIDs using the GuidStringCodec */ private function buildUuidBuilder(bool $useGuids = false): UuidBuilderInterface { if ($useGuids) { return new GuidBuilder($this->numberConverter, $this->timeConverter); } return new FallbackBuilder([ new Rfc4122UuidBuilder($this->numberConverter, $this->timeConverter), new NonstandardUuidBuilder($this->numberConverter, $this->timeConverter), ]); } /** * Returns true if the PHP build is 64-bit */ private function is64BitSystem(): bool { return PHP_INT_SIZE === 8 && !$this->force32Bit; } } PK ! !p�D/ / Nonstandard/Fields.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Nonstandard; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Fields\SerializableFieldsTrait; use Ramsey\Uuid\Rfc4122\FieldsInterface; use Ramsey\Uuid\Rfc4122\VariantTrait; use Ramsey\Uuid\Type\Hexadecimal; use function bin2hex; use function dechex; use function hexdec; use function sprintf; use function str_pad; use function strlen; use function substr; use const STR_PAD_LEFT; /** * Nonstandard UUID fields do not conform to the RFC 4122 standard * * Since some systems may create nonstandard UUIDs, this implements the * Rfc4122\FieldsInterface, so that functionality of a nonstandard UUID is not * degraded, in the event these UUIDs are expected to contain RFC 4122 fields. * * Internally, this class represents the fields together as a 16-byte binary * string. * * @psalm-immutable */ final class Fields implements FieldsInterface { use SerializableFieldsTrait; use VariantTrait; /** * @param string $bytes A 16-byte binary string representation of a UUID * * @throws InvalidArgumentException if the byte string is not exactly 16 bytes */ public function __construct(private string $bytes) { if (strlen($this->bytes) !== 16) { throw new InvalidArgumentException( 'The byte string must be 16 bytes long; ' . 'received ' . strlen($this->bytes) . ' bytes' ); } } public function getBytes(): string { return $this->bytes; } public function getClockSeq(): Hexadecimal { $clockSeq = hexdec(bin2hex(substr($this->bytes, 8, 2))) & 0x3fff; return new Hexadecimal(str_pad(dechex($clockSeq), 4, '0', STR_PAD_LEFT)); } public function getClockSeqHiAndReserved(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 8, 1))); } public function getClockSeqLow(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 9, 1))); } public function getNode(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 10))); } public function getTimeHiAndVersion(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 6, 2))); } public function getTimeLow(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 0, 4))); } public function getTimeMid(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 4, 2))); } public function getTimestamp(): Hexadecimal { return new Hexadecimal(sprintf( '%03x%04s%08s', hexdec($this->getTimeHiAndVersion()->toString()) & 0x0fff, $this->getTimeMid()->toString(), $this->getTimeLow()->toString() )); } public function getVersion(): ?int { return null; } public function isNil(): bool { return false; } public function isMax(): bool { return false; } } PK ! >B #� � Nonstandard/Uuid.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Nonstandard; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Uuid as BaseUuid; /** * Nonstandard\Uuid is a UUID that doesn't conform to RFC 4122 * * @psalm-immutable */ final class Uuid extends BaseUuid { public function __construct( Fields $fields, NumberConverterInterface $numberConverter, CodecInterface $codec, TimeConverterInterface $timeConverter ) { parent::__construct($fields, $numberConverter, $codec, $timeConverter); } } PK ! �� � � Nonstandard/UuidBuilder.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Nonstandard; use Ramsey\Uuid\Builder\UuidBuilderInterface; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\UnableToBuildUuidException; use Ramsey\Uuid\UuidInterface; use Throwable; /** * Nonstandard\UuidBuilder builds instances of Nonstandard\Uuid * * @psalm-immutable */ class UuidBuilder implements UuidBuilderInterface { /** * @param NumberConverterInterface $numberConverter The number converter to * use when constructing the Nonstandard\Uuid * @param TimeConverterInterface $timeConverter The time converter to use * for converting timestamps extracted from a UUID to Unix timestamps */ public function __construct( private NumberConverterInterface $numberConverter, private TimeConverterInterface $timeConverter ) { } /** * Builds and returns a Nonstandard\Uuid * * @param CodecInterface $codec The codec to use for building this instance * @param string $bytes The byte string from which to construct a UUID * * @return Uuid The Nonstandard\UuidBuilder returns an instance of * Nonstandard\Uuid * * @psalm-pure */ public function build(CodecInterface $codec, string $bytes): UuidInterface { try { return new Uuid( $this->buildFields($bytes), $this->numberConverter, $codec, $this->timeConverter ); } catch (Throwable $e) { throw new UnableToBuildUuidException($e->getMessage(), (int) $e->getCode(), $e); } } /** * Proxy method to allow injecting a mock, for testing */ protected function buildFields(string $bytes): Fields { return new Fields($bytes); } } PK ! ,� 2L L Nonstandard/UuidV6.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Nonstandard; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Lazy\LazyUuidFromString; use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface; use Ramsey\Uuid\Rfc4122\TimeTrait; use Ramsey\Uuid\Rfc4122\UuidInterface; use Ramsey\Uuid\Rfc4122\UuidV1; use Ramsey\Uuid\Uuid as BaseUuid; /** * Reordered time, or version 6, UUIDs include timestamp, clock sequence, and * node values that are combined into a 128-bit unsigned integer * * @deprecated Use {@see \Ramsey\Uuid\Rfc4122\UuidV6} instead. * * @link https://github.com/uuid6/uuid6-ietf-draft UUID version 6 IETF draft * @link http://gh.peabody.io/uuidv6/ "Version 6" UUIDs * * @psalm-immutable */ class UuidV6 extends BaseUuid implements UuidInterface { use TimeTrait; /** * Creates a version 6 (reordered time) UUID * * @param Rfc4122FieldsInterface $fields The fields from which to construct a UUID * @param NumberConverterInterface $numberConverter The number converter to use * for converting hex values to/from integers * @param CodecInterface $codec The codec to use when encoding or decoding * UUID strings * @param TimeConverterInterface $timeConverter The time converter to use * for converting timestamps extracted from a UUID to unix timestamps */ public function __construct( Rfc4122FieldsInterface $fields, NumberConverterInterface $numberConverter, CodecInterface $codec, TimeConverterInterface $timeConverter ) { if ($fields->getVersion() !== Uuid::UUID_TYPE_REORDERED_TIME) { throw new InvalidArgumentException( 'Fields used to create a UuidV6 must represent a ' . 'version 6 (reordered time) UUID' ); } parent::__construct($fields, $numberConverter, $codec, $timeConverter); } /** * Converts this UUID into an instance of a version 1 UUID */ public function toUuidV1(): UuidV1 { $hex = $this->getHex()->toString(); $hex = substr($hex, 7, 5) . substr($hex, 13, 3) . substr($hex, 3, 4) . '1' . substr($hex, 0, 3) . substr($hex, 16); /** @var LazyUuidFromString $uuid */ $uuid = Uuid::fromBytes((string) hex2bin($hex)); return $uuid->toUuidV1(); } /** * Converts a version 1 UUID into an instance of a version 6 UUID */ public static function fromUuidV1(UuidV1 $uuidV1): \Ramsey\Uuid\Rfc4122\UuidV6 { $hex = $uuidV1->getHex()->toString(); $hex = substr($hex, 13, 3) . substr($hex, 8, 4) . substr($hex, 0, 5) . '6' . substr($hex, 5, 3) . substr($hex, 16); /** @var LazyUuidFromString $uuid */ $uuid = Uuid::fromBytes((string) hex2bin($hex)); return $uuid->toUuidV6(); } } PK ! o�� functions.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT * phpcs:disable Squiz.Functions.GlobalFunction */ declare(strict_types=1); namespace Ramsey\Uuid; use DateTimeInterface; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; /** * Returns a version 1 (Gregorian time) UUID from a host ID, sequence number, * and the current time * * @param Hexadecimal|int|string|null $node A 48-bit number representing the * hardware address; this number may be represented as an integer or a * hexadecimal string * @param int|null $clockSeq A 14-bit number used to help avoid duplicates that * could arise when the clock is set backwards in time or if the node ID * changes * * @return non-empty-string Version 1 UUID as a string */ function v1($node = null, ?int $clockSeq = null): string { return Uuid::uuid1($node, $clockSeq)->toString(); } /** * Returns a version 2 (DCE Security) UUID from a local domain, local * identifier, host ID, clock sequence, and the current time * * @param int $localDomain The local domain to use when generating bytes, * according to DCE Security * @param IntegerObject|null $localIdentifier The local identifier for the * given domain; this may be a UID or GID on POSIX systems, if the local * domain is person or group, or it may be a site-defined identifier * if the local domain is org * @param Hexadecimal|null $node A 48-bit number representing the hardware * address * @param int|null $clockSeq A 14-bit number used to help avoid duplicates * that could arise when the clock is set backwards in time or if the * node ID changes * * @return non-empty-string Version 2 UUID as a string */ function v2( int $localDomain, ?IntegerObject $localIdentifier = null, ?Hexadecimal $node = null, ?int $clockSeq = null ): string { return Uuid::uuid2($localDomain, $localIdentifier, $node, $clockSeq)->toString(); } /** * Returns a version 3 (name-based) UUID based on the MD5 hash of a * namespace ID and a name * * @param string|UuidInterface $ns The namespace (must be a valid UUID) * * @return non-empty-string Version 3 UUID as a string * * @psalm-pure note: changing the internal factory is an edge case not covered by purity invariants, * but under constant factory setups, this method operates in functionally pure manners */ function v3($ns, string $name): string { return Uuid::uuid3($ns, $name)->toString(); } /** * Returns a version 4 (random) UUID * * @return non-empty-string Version 4 UUID as a string */ function v4(): string { return Uuid::uuid4()->toString(); } /** * Returns a version 5 (name-based) UUID based on the SHA-1 hash of a * namespace ID and a name * * @param string|UuidInterface $ns The namespace (must be a valid UUID) * * @return non-empty-string Version 5 UUID as a string * * @psalm-pure note: changing the internal factory is an edge case not covered by purity invariants, * but under constant factory setups, this method operates in functionally pure manners */ function v5($ns, string $name): string { return Uuid::uuid5($ns, $name)->toString(); } /** * Returns a version 6 (reordered time) UUID from a host ID, sequence number, * and the current time * * @param Hexadecimal|null $node A 48-bit number representing the hardware * address * @param int|null $clockSeq A 14-bit number used to help avoid duplicates that * could arise when the clock is set backwards in time or if the node ID * changes * * @return non-empty-string Version 6 UUID as a string */ function v6(?Hexadecimal $node = null, ?int $clockSeq = null): string { return Uuid::uuid6($node, $clockSeq)->toString(); } /** * Returns a version 7 (Unix Epoch time) UUID * * @param DateTimeInterface|null $dateTime An optional date/time from which * to create the version 7 UUID. If not provided, the UUID is generated * using the current date/time. * * @return non-empty-string Version 7 UUID as a string */ function v7(?DateTimeInterface $dateTime = null): string { return Uuid::uuid7($dateTime)->toString(); } /** * Returns a version 8 (custom) UUID * * The bytes provided may contain any value according to your application's * needs. Be aware, however, that other applications may not understand the * semantics of the value. * * @param string $bytes A 16-byte octet string. This is an open blob * of data that you may fill with 128 bits of information. Be aware, * however, bits 48 through 51 will be replaced with the UUID version * field, and bits 64 and 65 will be replaced with the UUID variant. You * MUST NOT rely on these bits for your application needs. * * @return non-empty-string Version 8 UUID as a string */ function v8(string $bytes): string { return Uuid::uuid8($bytes)->toString(); } PK ! v����e �e Uuid.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid; use BadMethodCallException; use DateTimeInterface; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\UnsupportedOperationException; use Ramsey\Uuid\Fields\FieldsInterface; use Ramsey\Uuid\Lazy\LazyUuidFromString; use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; use ValueError; use function assert; use function bin2hex; use function method_exists; use function preg_match; use function sprintf; use function str_replace; use function strcmp; use function strlen; use function strtolower; use function substr; /** * Uuid provides constants and static methods for working with and generating UUIDs * * @psalm-immutable */ class Uuid implements UuidInterface { use DeprecatedUuidMethodsTrait; /** * When this namespace is specified, the name string is a fully-qualified * domain name * * @link http://tools.ietf.org/html/rfc4122#appendix-C RFC 4122, Appendix C: Some Name Space IDs */ public const NAMESPACE_DNS = '6ba7b810-9dad-11d1-80b4-00c04fd430c8'; /** * When this namespace is specified, the name string is a URL * * @link http://tools.ietf.org/html/rfc4122#appendix-C RFC 4122, Appendix C: Some Name Space IDs */ public const NAMESPACE_URL = '6ba7b811-9dad-11d1-80b4-00c04fd430c8'; /** * When this namespace is specified, the name string is an ISO OID * * @link http://tools.ietf.org/html/rfc4122#appendix-C RFC 4122, Appendix C: Some Name Space IDs */ public const NAMESPACE_OID = '6ba7b812-9dad-11d1-80b4-00c04fd430c8'; /** * When this namespace is specified, the name string is an X.500 DN in DER * or a text output format * * @link http://tools.ietf.org/html/rfc4122#appendix-C RFC 4122, Appendix C: Some Name Space IDs */ public const NAMESPACE_X500 = '6ba7b814-9dad-11d1-80b4-00c04fd430c8'; /** * The nil UUID is a special form of UUID that is specified to have all 128 * bits set to zero * * @link http://tools.ietf.org/html/rfc4122#section-4.1.7 RFC 4122, § 4.1.7: Nil UUID */ public const NIL = '00000000-0000-0000-0000-000000000000'; /** * The max UUID is a special form of UUID that is specified to have all 128 * bits set to one * * @link https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.10 Max UUID */ public const MAX = 'ffffffff-ffff-ffff-ffff-ffffffffffff'; /** * Variant: reserved, NCS backward compatibility * * @link http://tools.ietf.org/html/rfc4122#section-4.1.1 RFC 4122, § 4.1.1: Variant */ public const RESERVED_NCS = 0; /** * Variant: the UUID layout specified in RFC 4122 * * @link http://tools.ietf.org/html/rfc4122#section-4.1.1 RFC 4122, § 4.1.1: Variant */ public const RFC_4122 = 2; /** * Variant: reserved, Microsoft Corporation backward compatibility * * @link http://tools.ietf.org/html/rfc4122#section-4.1.1 RFC 4122, § 4.1.1: Variant */ public const RESERVED_MICROSOFT = 6; /** * Variant: reserved for future definition * * @link http://tools.ietf.org/html/rfc4122#section-4.1.1 RFC 4122, § 4.1.1: Variant */ public const RESERVED_FUTURE = 7; /** * @deprecated Use {@see ValidatorInterface::getPattern()} instead. */ public const VALID_PATTERN = '^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$'; /** * Version 1 (Gregorian time) UUID * * @link https://tools.ietf.org/html/rfc4122#section-4.1.3 RFC 4122, § 4.1.3: Version */ public const UUID_TYPE_TIME = 1; /** * Version 2 (DCE Security) UUID * * @link https://tools.ietf.org/html/rfc4122#section-4.1.3 RFC 4122, § 4.1.3: Version */ public const UUID_TYPE_DCE_SECURITY = 2; /** * @deprecated Use {@see Uuid::UUID_TYPE_DCE_SECURITY} instead. */ public const UUID_TYPE_IDENTIFIER = 2; /** * Version 3 (name-based and hashed with MD5) UUID * * @link https://tools.ietf.org/html/rfc4122#section-4.1.3 RFC 4122, § 4.1.3: Version */ public const UUID_TYPE_HASH_MD5 = 3; /** * Version 4 (random) UUID * * @link https://tools.ietf.org/html/rfc4122#section-4.1.3 RFC 4122, § 4.1.3: Version */ public const UUID_TYPE_RANDOM = 4; /** * Version 5 (name-based and hashed with SHA1) UUID * * @link https://tools.ietf.org/html/rfc4122#section-4.1.3 RFC 4122, § 4.1.3: Version */ public const UUID_TYPE_HASH_SHA1 = 5; /** * @deprecated Use {@see Uuid::UUID_TYPE_REORDERED_TIME} instead. */ public const UUID_TYPE_PEABODY = 6; /** * Version 6 (reordered time) UUID * * @link https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.6 UUID Version 6 */ public const UUID_TYPE_REORDERED_TIME = 6; /** * Version 7 (Unix Epoch time) UUID * * @link https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.7 UUID Version 7 */ public const UUID_TYPE_UNIX_TIME = 7; /** * @link https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis-00#section-5.8 UUID Version 8 */ public const UUID_TYPE_CUSTOM = 8; /** * DCE Security principal domain * * @link https://pubs.opengroup.org/onlinepubs/9696989899/chap11.htm#tagcjh_14_05_01_01 DCE 1.1, §11.5.1.1 */ public const DCE_DOMAIN_PERSON = 0; /** * DCE Security group domain * * @link https://pubs.opengroup.org/onlinepubs/9696989899/chap11.htm#tagcjh_14_05_01_01 DCE 1.1, §11.5.1.1 */ public const DCE_DOMAIN_GROUP = 1; /** * DCE Security organization domain * * @link https://pubs.opengroup.org/onlinepubs/9696989899/chap11.htm#tagcjh_14_05_01_01 DCE 1.1, §11.5.1.1 */ public const DCE_DOMAIN_ORG = 2; /** * DCE Security domain string names * * @link https://pubs.opengroup.org/onlinepubs/9696989899/chap11.htm#tagcjh_14_05_01_01 DCE 1.1, §11.5.1.1 */ public const DCE_DOMAIN_NAMES = [ self::DCE_DOMAIN_PERSON => 'person', self::DCE_DOMAIN_GROUP => 'group', self::DCE_DOMAIN_ORG => 'org', ]; private static ?UuidFactoryInterface $factory = null; /** * @var bool flag to detect if the UUID factory was replaced internally, * which disables all optimizations for the default/happy path internal * scenarios */ private static bool $factoryReplaced = false; protected CodecInterface $codec; protected NumberConverterInterface $numberConverter; protected Rfc4122FieldsInterface $fields; protected TimeConverterInterface $timeConverter; /** * Creates a universally unique identifier (UUID) from an array of fields * * Unless you're making advanced use of this library to generate identifiers * that deviate from RFC 4122, you probably do not want to instantiate a * UUID directly. Use the static methods, instead: * * ``` * use Ramsey\Uuid\Uuid; * * $timeBasedUuid = Uuid::uuid1(); * $namespaceMd5Uuid = Uuid::uuid3(Uuid::NAMESPACE_URL, 'http://php.net/'); * $randomUuid = Uuid::uuid4(); * $namespaceSha1Uuid = Uuid::uuid5(Uuid::NAMESPACE_URL, 'http://php.net/'); * ``` * * @param Rfc4122FieldsInterface $fields The fields from which to construct a UUID * @param NumberConverterInterface $numberConverter The number converter to use * for converting hex values to/from integers * @param CodecInterface $codec The codec to use when encoding or decoding * UUID strings * @param TimeConverterInterface $timeConverter The time converter to use * for converting timestamps extracted from a UUID to unix timestamps */ public function __construct( Rfc4122FieldsInterface $fields, NumberConverterInterface $numberConverter, CodecInterface $codec, TimeConverterInterface $timeConverter ) { $this->fields = $fields; $this->codec = $codec; $this->numberConverter = $numberConverter; $this->timeConverter = $timeConverter; } /** * @psalm-return non-empty-string */ public function __toString(): string { return $this->toString(); } /** * Converts the UUID to a string for JSON serialization */ public function jsonSerialize(): string { return $this->toString(); } /** * Converts the UUID to a string for PHP serialization */ public function serialize(): string { return $this->codec->encode($this); } /** * @return array{bytes: string} */ public function __serialize(): array { return ['bytes' => $this->serialize()]; } /** * Re-constructs the object from its serialized form * * @param string $data The serialized PHP string to unserialize into * a UuidInterface instance */ public function unserialize(string $data): void { if (strlen($data) === 16) { /** @var Uuid $uuid */ $uuid = self::getFactory()->fromBytes($data); } else { /** @var Uuid $uuid */ $uuid = self::getFactory()->fromString($data); } $this->codec = $uuid->codec; $this->numberConverter = $uuid->numberConverter; $this->fields = $uuid->fields; $this->timeConverter = $uuid->timeConverter; } /** * @param array{bytes?: string} $data */ public function __unserialize(array $data): void { // @codeCoverageIgnoreStart if (!isset($data['bytes'])) { throw new ValueError(sprintf('%s(): Argument #1 ($data) is invalid', __METHOD__)); } // @codeCoverageIgnoreEnd $this->unserialize($data['bytes']); } public function compareTo(UuidInterface $other): int { $compare = strcmp($this->toString(), $other->toString()); if ($compare < 0) { return -1; } if ($compare > 0) { return 1; } return 0; } public function equals(?object $other): bool { if (!$other instanceof UuidInterface) { return false; } return $this->compareTo($other) === 0; } /** * @psalm-return non-empty-string */ public function getBytes(): string { return $this->codec->encodeBinary($this); } public function getFields(): FieldsInterface { return $this->fields; } public function getHex(): Hexadecimal { return new Hexadecimal(str_replace('-', '', $this->toString())); } public function getInteger(): IntegerObject { return new IntegerObject($this->numberConverter->fromHex($this->getHex()->toString())); } public function getUrn(): string { return 'urn:uuid:' . $this->toString(); } /** * @psalm-return non-empty-string */ public function toString(): string { return $this->codec->encode($this); } /** * Returns the factory used to create UUIDs */ public static function getFactory(): UuidFactoryInterface { if (self::$factory === null) { self::$factory = new UuidFactory(); } return self::$factory; } /** * Sets the factory used to create UUIDs * * @param UuidFactoryInterface $factory A factory that will be used by this * class to create UUIDs */ public static function setFactory(UuidFactoryInterface $factory): void { // Note: non-strict equality is intentional here. If the factory is configured differently, every assumption // around purity is broken, and we have to internally decide everything differently. // phpcs:ignore SlevomatCodingStandard.Operators.DisallowEqualOperators.DisallowedNotEqualOperator self::$factoryReplaced = ($factory != new UuidFactory()); self::$factory = $factory; } /** * Creates a UUID from a byte string * * @param string $bytes A binary string * * @return UuidInterface A UuidInterface instance created from a binary * string representation * * @psalm-pure note: changing the internal factory is an edge case not covered by purity invariants, * but under constant factory setups, this method operates in functionally pure manners * * @psalm-suppress ImpureStaticProperty we know that the factory being replaced can lead to massive * havoc across all consumers: that should never happen, and * is generally to be discouraged. Until the factory is kept * un-replaced, this method is effectively pure. */ public static function fromBytes(string $bytes): UuidInterface { if (!self::$factoryReplaced && strlen($bytes) === 16) { $base16Uuid = bin2hex($bytes); // Note: we are calling `fromString` internally because we don't know if the given `$bytes` is a valid UUID return self::fromString( substr($base16Uuid, 0, 8) . '-' . substr($base16Uuid, 8, 4) . '-' . substr($base16Uuid, 12, 4) . '-' . substr($base16Uuid, 16, 4) . '-' . substr($base16Uuid, 20, 12) ); } return self::getFactory()->fromBytes($bytes); } /** * Creates a UUID from the string standard representation * * @param string $uuid A hexadecimal string * * @return UuidInterface A UuidInterface instance created from a hexadecimal * string representation * * @psalm-pure note: changing the internal factory is an edge case not covered by purity invariants, * but under constant factory setups, this method operates in functionally pure manners * * @psalm-suppress ImpureStaticProperty we know that the factory being replaced can lead to massive * havoc across all consumers: that should never happen, and * is generally to be discouraged. Until the factory is kept * un-replaced, this method is effectively pure. */ public static function fromString(string $uuid): UuidInterface { $uuid = strtolower($uuid); if (!self::$factoryReplaced && preg_match(LazyUuidFromString::VALID_REGEX, $uuid) === 1) { assert($uuid !== ''); return new LazyUuidFromString($uuid); } return self::getFactory()->fromString($uuid); } /** * Creates a UUID from a DateTimeInterface instance * * @param DateTimeInterface $dateTime The date and time * @param Hexadecimal|null $node A 48-bit number representing the hardware * address * @param int|null $clockSeq A 14-bit number used to help avoid duplicates * that could arise when the clock is set backwards in time or if the * node ID changes * * @return UuidInterface A UuidInterface instance that represents a * version 1 UUID created from a DateTimeInterface instance */ public static function fromDateTime( DateTimeInterface $dateTime, ?Hexadecimal $node = null, ?int $clockSeq = null ): UuidInterface { return self::getFactory()->fromDateTime($dateTime, $node, $clockSeq); } /** * Creates a UUID from the Hexadecimal object * * @param Hexadecimal $hex Hexadecimal object representing a hexadecimal number * * @return UuidInterface A UuidInterface instance created from the Hexadecimal * object representing a hexadecimal number * * @psalm-pure note: changing the internal factory is an edge case not covered by purity invariants, * but under constant factory setups, this method operates in functionally pure manners * @psalm-suppress MixedInferredReturnType,MixedReturnStatement */ public static function fromHexadecimal(Hexadecimal $hex): UuidInterface { $factory = self::getFactory(); if (method_exists($factory, 'fromHexadecimal')) { /** * @phpstan-ignore-next-line * @psalm-suppress UndefinedInterfaceMethod */ return self::getFactory()->fromHexadecimal($hex); } throw new BadMethodCallException('The method fromHexadecimal() does not exist on the provided factory'); } /** * Creates a UUID from a 128-bit integer string * * @param string $integer String representation of 128-bit integer * * @return UuidInterface A UuidInterface instance created from the string * representation of a 128-bit integer * * @psalm-pure note: changing the internal factory is an edge case not covered by purity invariants, * but under constant factory setups, this method operates in functionally pure manners */ public static function fromInteger(string $integer): UuidInterface { /** @psalm-suppress ImpureMethodCall */ return self::getFactory()->fromInteger($integer); } /** * Returns true if the provided string is a valid UUID * * @param string $uuid A string to validate as a UUID * * @return bool True if the string is a valid UUID, false otherwise * * @psalm-pure note: changing the internal factory is an edge case not covered by purity invariants, * but under constant factory setups, this method operates in functionally pure manners * * @psalm-assert-if-true =non-empty-string $uuid */ public static function isValid(string $uuid): bool { /** @psalm-suppress ImpureMethodCall */ return self::getFactory()->getValidator()->validate($uuid); } /** * Returns a version 1 (Gregorian time) UUID from a host ID, sequence number, * and the current time * * @param Hexadecimal|int|string|null $node A 48-bit number representing the * hardware address; this number may be represented as an integer or a * hexadecimal string * @param int|null $clockSeq A 14-bit number used to help avoid duplicates that * could arise when the clock is set backwards in time or if the node ID * changes * * @return UuidInterface A UuidInterface instance that represents a * version 1 UUID */ public static function uuid1($node = null, ?int $clockSeq = null): UuidInterface { return self::getFactory()->uuid1($node, $clockSeq); } /** * Returns a version 2 (DCE Security) UUID from a local domain, local * identifier, host ID, clock sequence, and the current time * * @param int $localDomain The local domain to use when generating bytes, * according to DCE Security * @param IntegerObject|null $localIdentifier The local identifier for the * given domain; this may be a UID or GID on POSIX systems, if the local * domain is person or group, or it may be a site-defined identifier * if the local domain is org * @param Hexadecimal|null $node A 48-bit number representing the hardware * address * @param int|null $clockSeq A 14-bit number used to help avoid duplicates * that could arise when the clock is set backwards in time or if the * node ID changes (in a version 2 UUID, the lower 8 bits of this number * are replaced with the domain). * * @return UuidInterface A UuidInterface instance that represents a * version 2 UUID */ public static function uuid2( int $localDomain, ?IntegerObject $localIdentifier = null, ?Hexadecimal $node = null, ?int $clockSeq = null ): UuidInterface { return self::getFactory()->uuid2($localDomain, $localIdentifier, $node, $clockSeq); } /** * Returns a version 3 (name-based) UUID based on the MD5 hash of a * namespace ID and a name * * @param string|UuidInterface $ns The namespace (must be a valid UUID) * @param string $name The name to use for creating a UUID * * @return UuidInterface A UuidInterface instance that represents a * version 3 UUID * * @psalm-suppress ImpureMethodCall we know that the factory being replaced can lead to massive * havoc across all consumers: that should never happen, and * is generally to be discouraged. Until the factory is kept * un-replaced, this method is effectively pure. * * @psalm-pure note: changing the internal factory is an edge case not covered by purity invariants, * but under constant factory setups, this method operates in functionally pure manners */ public static function uuid3($ns, string $name): UuidInterface { return self::getFactory()->uuid3($ns, $name); } /** * Returns a version 4 (random) UUID * * @return UuidInterface A UuidInterface instance that represents a * version 4 UUID */ public static function uuid4(): UuidInterface { return self::getFactory()->uuid4(); } /** * Returns a version 5 (name-based) UUID based on the SHA-1 hash of a * namespace ID and a name * * @param string|UuidInterface $ns The namespace (must be a valid UUID) * @param string $name The name to use for creating a UUID * * @return UuidInterface A UuidInterface instance that represents a * version 5 UUID * * @psalm-pure note: changing the internal factory is an edge case not covered by purity invariants, * but under constant factory setups, this method operates in functionally pure manners * * @psalm-suppress ImpureMethodCall we know that the factory being replaced can lead to massive * havoc across all consumers: that should never happen, and * is generally to be discouraged. Until the factory is kept * un-replaced, this method is effectively pure. */ public static function uuid5($ns, string $name): UuidInterface { return self::getFactory()->uuid5($ns, $name); } /** * Returns a version 6 (reordered time) UUID from a host ID, sequence number, * and the current time * * @param Hexadecimal|null $node A 48-bit number representing the hardware * address * @param int|null $clockSeq A 14-bit number used to help avoid duplicates that * could arise when the clock is set backwards in time or if the node ID * changes * * @return UuidInterface A UuidInterface instance that represents a * version 6 UUID */ public static function uuid6( ?Hexadecimal $node = null, ?int $clockSeq = null ): UuidInterface { return self::getFactory()->uuid6($node, $clockSeq); } /** * Returns a version 7 (Unix Epoch time) UUID * * @param DateTimeInterface|null $dateTime An optional date/time from which * to create the version 7 UUID. If not provided, the UUID is generated * using the current date/time. * * @return UuidInterface A UuidInterface instance that represents a * version 7 UUID */ public static function uuid7(?DateTimeInterface $dateTime = null): UuidInterface { $factory = self::getFactory(); if (method_exists($factory, 'uuid7')) { /** @var UuidInterface */ return $factory->uuid7($dateTime); } throw new UnsupportedOperationException( 'The provided factory does not support the uuid7() method', ); } /** * Returns a version 8 (custom) UUID * * The bytes provided may contain any value according to your application's * needs. Be aware, however, that other applications may not understand the * semantics of the value. * * @param string $bytes A 16-byte octet string. This is an open blob * of data that you may fill with 128 bits of information. Be aware, * however, bits 48 through 51 will be replaced with the UUID version * field, and bits 64 and 65 will be replaced with the UUID variant. You * MUST NOT rely on these bits for your application needs. * * @return UuidInterface A UuidInterface instance that represents a * version 8 UUID */ public static function uuid8(string $bytes): UuidInterface { $factory = self::getFactory(); if (method_exists($factory, 'uuid8')) { /** @var UuidInterface */ return $factory->uuid8($bytes); } throw new UnsupportedOperationException( 'The provided factory does not support the uuid8() method', ); } } PK ! ��� � Codec/GuidStringCodec.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Codec; use Ramsey\Uuid\Guid\Guid; use Ramsey\Uuid\UuidInterface; use function bin2hex; use function sprintf; use function substr; /** * GuidStringCodec encodes and decodes globally unique identifiers (GUID) * * @see Guid * * @psalm-immutable */ class GuidStringCodec extends StringCodec { public function encode(UuidInterface $uuid): string { $hex = bin2hex($uuid->getFields()->getBytes()); /** @var non-empty-string */ return sprintf( '%02s%02s%02s%02s-%02s%02s-%02s%02s-%04s-%012s', substr($hex, 6, 2), substr($hex, 4, 2), substr($hex, 2, 2), substr($hex, 0, 2), substr($hex, 10, 2), substr($hex, 8, 2), substr($hex, 14, 2), substr($hex, 12, 2), substr($hex, 16, 4), substr($hex, 20), ); } public function decode(string $encodedUuid): UuidInterface { $bytes = $this->getBytes($encodedUuid); return $this->getBuilder()->build($this, $this->swapBytes($bytes)); } public function decodeBytes(string $bytes): UuidInterface { // Specifically call parent::decode to preserve correct byte order return parent::decode(bin2hex($bytes)); } /** * Swaps bytes according to the GUID rules */ private function swapBytes(string $bytes): string { return $bytes[3] . $bytes[2] . $bytes[1] . $bytes[0] . $bytes[5] . $bytes[4] . $bytes[7] . $bytes[6] . substr($bytes, 8); } } PK ! �L�� � Codec/OrderedTimeCodec.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Codec; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Exception\UnsupportedOperationException; use Ramsey\Uuid\Rfc4122\FieldsInterface as Rfc4122FieldsInterface; use Ramsey\Uuid\Uuid; use Ramsey\Uuid\UuidInterface; use function strlen; use function substr; /** * OrderedTimeCodec encodes and decodes a UUID, optimizing the byte order for * more efficient storage * * For binary representations of version 1 UUID, this codec may be used to * reorganize the time fields, making the UUID closer to sequential when storing * the bytes. According to Percona, this optimization can improve database * INSERTs and SELECTs using the UUID column as a key. * * The string representation of the UUID will remain unchanged. Only the binary * representation is reordered. * * **PLEASE NOTE:** Binary representations of UUIDs encoded with this codec must * be decoded with this codec. Decoding using another codec can result in * malformed UUIDs. * * @link https://www.percona.com/blog/2014/12/19/store-uuid-optimized-way/ Storing UUID Values in MySQL * * @psalm-immutable */ class OrderedTimeCodec extends StringCodec { /** * Returns a binary string representation of a UUID, with the timestamp * fields rearranged for optimized storage * * @inheritDoc * @psalm-return non-empty-string * @psalm-suppress MoreSpecificReturnType we know that the retrieved `string` is never empty * @psalm-suppress LessSpecificReturnStatement we know that the retrieved `string` is never empty */ public function encodeBinary(UuidInterface $uuid): string { if ( !($uuid->getFields() instanceof Rfc4122FieldsInterface) || $uuid->getFields()->getVersion() !== Uuid::UUID_TYPE_TIME ) { throw new InvalidArgumentException( 'Expected RFC 4122 version 1 (time-based) UUID' ); } $bytes = $uuid->getFields()->getBytes(); /** @phpstan-ignore-next-line PHPStan complains that this is not a non-empty-string. */ return $bytes[6] . $bytes[7] . $bytes[4] . $bytes[5] . $bytes[0] . $bytes[1] . $bytes[2] . $bytes[3] . substr($bytes, 8); } /** * Returns a UuidInterface derived from an ordered-time binary string * representation * * @throws InvalidArgumentException if $bytes is an invalid length * * @inheritDoc */ public function decodeBytes(string $bytes): UuidInterface { if (strlen($bytes) !== 16) { throw new InvalidArgumentException( '$bytes string should contain 16 characters.' ); } // Rearrange the bytes to their original order. $rearrangedBytes = $bytes[4] . $bytes[5] . $bytes[6] . $bytes[7] . $bytes[2] . $bytes[3] . $bytes[0] . $bytes[1] . substr($bytes, 8); $uuid = parent::decodeBytes($rearrangedBytes); if ( !($uuid->getFields() instanceof Rfc4122FieldsInterface) || $uuid->getFields()->getVersion() !== Uuid::UUID_TYPE_TIME ) { throw new UnsupportedOperationException( 'Attempting to decode a non-time-based UUID using ' . 'OrderedTimeCodec' ); } return $uuid; } } PK ! {� �N N ! Codec/TimestampFirstCombCodec.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Codec; use Ramsey\Uuid\Exception\InvalidUuidStringException; use Ramsey\Uuid\UuidInterface; use function bin2hex; use function sprintf; use function substr; use function substr_replace; /** * TimestampFirstCombCodec encodes and decodes COMBs, with the timestamp as the * first 48 bits * * In contrast with the TimestampLastCombCodec, the TimestampFirstCombCodec * adds the timestamp to the first 48 bits of the COMB. To generate a * timestamp-first COMB, set the TimestampFirstCombCodec as the codec, along * with the CombGenerator as the random generator. * * ``` php * $factory = new UuidFactory(); * * $factory->setCodec(new TimestampFirstCombCodec($factory->getUuidBuilder())); * * $factory->setRandomGenerator(new CombGenerator( * $factory->getRandomGenerator(), * $factory->getNumberConverter() * )); * * $timestampFirstComb = $factory->uuid4(); * ``` * * @link https://www.informit.com/articles/printerfriendly/25862 The Cost of GUIDs as Primary Keys * * @psalm-immutable */ class TimestampFirstCombCodec extends StringCodec { /** * @psalm-return non-empty-string * @psalm-suppress MoreSpecificReturnType we know that the retrieved `string` is never empty * @psalm-suppress LessSpecificReturnStatement we know that the retrieved `string` is never empty */ public function encode(UuidInterface $uuid): string { $bytes = $this->swapBytes($uuid->getFields()->getBytes()); return sprintf( '%08s-%04s-%04s-%04s-%012s', bin2hex(substr($bytes, 0, 4)), bin2hex(substr($bytes, 4, 2)), bin2hex(substr($bytes, 6, 2)), bin2hex(substr($bytes, 8, 2)), bin2hex(substr($bytes, 10)) ); } /** * @psalm-return non-empty-string * @psalm-suppress MoreSpecificReturnType we know that the retrieved `string` is never empty * @psalm-suppress LessSpecificReturnStatement we know that the retrieved `string` is never empty */ public function encodeBinary(UuidInterface $uuid): string { /** @phpstan-ignore-next-line PHPStan complains that this is not a non-empty-string. */ return $this->swapBytes($uuid->getFields()->getBytes()); } /** * @throws InvalidUuidStringException * * @inheritDoc */ public function decode(string $encodedUuid): UuidInterface { $bytes = $this->getBytes($encodedUuid); return $this->getBuilder()->build($this, $this->swapBytes($bytes)); } public function decodeBytes(string $bytes): UuidInterface { return $this->getBuilder()->build($this, $this->swapBytes($bytes)); } /** * Swaps bytes according to the timestamp-first COMB rules */ private function swapBytes(string $bytes): string { $first48Bits = substr($bytes, 0, 6); $last48Bits = substr($bytes, -6); $bytes = substr_replace($bytes, $last48Bits, 0, 6); $bytes = substr_replace($bytes, $first48Bits, -6); return $bytes; } } PK ! o c c Codec/StringCodec.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Codec; use Ramsey\Uuid\Builder\UuidBuilderInterface; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Exception\InvalidUuidStringException; use Ramsey\Uuid\Uuid; use Ramsey\Uuid\UuidInterface; use function bin2hex; use function hex2bin; use function implode; use function sprintf; use function str_replace; use function strlen; use function substr; /** * StringCodec encodes and decodes RFC 4122 UUIDs * * @link http://tools.ietf.org/html/rfc4122 * * @psalm-immutable */ class StringCodec implements CodecInterface { /** * Constructs a StringCodec * * @param UuidBuilderInterface $builder The builder to use when encoding UUIDs */ public function __construct(private UuidBuilderInterface $builder) { } public function encode(UuidInterface $uuid): string { $hex = bin2hex($uuid->getFields()->getBytes()); /** @var non-empty-string */ return sprintf( '%08s-%04s-%04s-%04s-%012s', substr($hex, 0, 8), substr($hex, 8, 4), substr($hex, 12, 4), substr($hex, 16, 4), substr($hex, 20), ); } /** * @psalm-return non-empty-string * @psalm-suppress MoreSpecificReturnType we know that the retrieved `string` is never empty * @psalm-suppress LessSpecificReturnStatement we know that the retrieved `string` is never empty */ public function encodeBinary(UuidInterface $uuid): string { /** @phpstan-ignore-next-line PHPStan complains that this is not a non-empty-string. */ return $uuid->getFields()->getBytes(); } /** * @throws InvalidUuidStringException * * @inheritDoc */ public function decode(string $encodedUuid): UuidInterface { return $this->builder->build($this, $this->getBytes($encodedUuid)); } public function decodeBytes(string $bytes): UuidInterface { if (strlen($bytes) !== 16) { throw new InvalidArgumentException( '$bytes string should contain 16 characters.' ); } return $this->builder->build($this, $bytes); } /** * Returns the UUID builder */ protected function getBuilder(): UuidBuilderInterface { return $this->builder; } /** * Returns a byte string of the UUID */ protected function getBytes(string $encodedUuid): string { $parsedUuid = str_replace( ['urn:', 'uuid:', 'URN:', 'UUID:', '{', '}', '-'], '', $encodedUuid ); $components = [ substr($parsedUuid, 0, 8), substr($parsedUuid, 8, 4), substr($parsedUuid, 12, 4), substr($parsedUuid, 16, 4), substr($parsedUuid, 20), ]; if (!Uuid::isValid(implode('-', $components))) { throw new InvalidUuidStringException( 'Invalid UUID string: ' . $encodedUuid ); } return (string) hex2bin($parsedUuid); } } PK ! �h� Codec/CodecInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Codec; use Ramsey\Uuid\UuidInterface; /** * A codec encodes and decodes a UUID according to defined rules * * @psalm-immutable */ interface CodecInterface { /** * Returns a hexadecimal string representation of a UuidInterface * * @param UuidInterface $uuid The UUID for which to create a hexadecimal * string representation * * @return string Hexadecimal string representation of a UUID * * @psalm-return non-empty-string */ public function encode(UuidInterface $uuid): string; /** * Returns a binary string representation of a UuidInterface * * @param UuidInterface $uuid The UUID for which to create a binary string * representation * * @return string Binary string representation of a UUID * * @psalm-return non-empty-string */ public function encodeBinary(UuidInterface $uuid): string; /** * Returns a UuidInterface derived from a hexadecimal string representation * * @param string $encodedUuid The hexadecimal string representation to * convert into a UuidInterface instance * * @return UuidInterface An instance of a UUID decoded from a hexadecimal * string representation */ public function decode(string $encodedUuid): UuidInterface; /** * Returns a UuidInterface derived from a binary string representation * * @param string $bytes The binary string representation to convert into a * UuidInterface instance * * @return UuidInterface An instance of a UUID decoded from a binary string * representation */ public function decodeBytes(string $bytes): UuidInterface; } PK ! 8Gb=N N Codec/TimestampLastCombCodec.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Codec; /** * TimestampLastCombCodec encodes and decodes COMBs, with the timestamp as the * last 48 bits * * The CombGenerator when used with the StringCodec (and, by proxy, the * TimestampLastCombCodec) adds the timestamp to the last 48 bits of the COMB. * The TimestampLastCombCodec is provided for the sake of consistency. In * practice, it is identical to the standard StringCodec but, it may be used * with the CombGenerator for additional context when reading code. * * Consider the following code. By default, the codec used by UuidFactory is the * StringCodec, but here, we explicitly set the TimestampLastCombCodec. It is * redundant, but it is clear that we intend this COMB to be generated with the * timestamp appearing at the end. * * ``` php * $factory = new UuidFactory(); * * $factory->setCodec(new TimestampLastCombCodec($factory->getUuidBuilder())); * * $factory->setRandomGenerator(new CombGenerator( * $factory->getRandomGenerator(), * $factory->getNumberConverter() * )); * * $timestampLastComb = $factory->uuid4(); * ``` * * @link https://www.informit.com/articles/printerfriendly/25862 The Cost of GUIDs as Primary Keys * * @psalm-immutable */ class TimestampLastCombCodec extends StringCodec { } PK ! �fT�6 6 " Provider/TimeProviderInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Provider; use Ramsey\Uuid\Type\Time; /** * A time provider retrieves the current time */ interface TimeProviderInterface { /** * Returns a time object */ public function getTime(): Time; } PK ! `��� � " Provider/NodeProviderInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Provider; use Ramsey\Uuid\Type\Hexadecimal; /** * A node provider retrieves or generates a node ID */ interface NodeProviderInterface { /** * Returns a node ID * * @return Hexadecimal The node ID as a hexadecimal string */ public function getNode(): Hexadecimal; } PK ! �v � � $ Provider/Time/SystemTimeProvider.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Provider\Time; use Ramsey\Uuid\Provider\TimeProviderInterface; use Ramsey\Uuid\Type\Time; use function gettimeofday; /** * SystemTimeProvider retrieves the current time using built-in PHP functions */ class SystemTimeProvider implements TimeProviderInterface { public function getTime(): Time { $time = gettimeofday(); return new Time($time['sec'], $time['usec']); } } PK ! X�w w # Provider/Time/FixedTimeProvider.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Provider\Time; use Ramsey\Uuid\Provider\TimeProviderInterface; use Ramsey\Uuid\Type\Integer as IntegerObject; use Ramsey\Uuid\Type\Time; /** * FixedTimeProvider uses a known time to provide the time * * This provider allows the use of a previously-generated, or known, time * when generating time-based UUIDs. */ class FixedTimeProvider implements TimeProviderInterface { public function __construct(private Time $time) { } /** * Sets the `usec` component of the time * * @param int|string|IntegerObject $value The `usec` value to set */ public function setUsec($value): void { $this->time = new Time($this->time->getSeconds(), $value); } /** * Sets the `sec` component of the time * * @param int|string|IntegerObject $value The `sec` value to set */ public function setSec($value): void { $this->time = new Time($value, $this->time->getMicroseconds()); } public function getTime(): Time { return $this->time; } } PK ! �*�� � * Provider/Dce/SystemDceSecurityProvider.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Provider\Dce; use Ramsey\Uuid\Exception\DceSecurityException; use Ramsey\Uuid\Provider\DceSecurityProviderInterface; use Ramsey\Uuid\Type\Integer as IntegerObject; use function escapeshellarg; use function preg_split; use function str_getcsv; use function strrpos; use function strtolower; use function strtoupper; use function substr; use function trim; use const PREG_SPLIT_NO_EMPTY; /** * SystemDceSecurityProvider retrieves the user or group identifiers from the system */ class SystemDceSecurityProvider implements DceSecurityProviderInterface { /** * @throws DceSecurityException if unable to get a user identifier * * @inheritDoc */ public function getUid(): IntegerObject { /** @var int|float|string|IntegerObject|null $uid */ static $uid = null; if ($uid instanceof IntegerObject) { return $uid; } if ($uid === null) { $uid = $this->getSystemUid(); } if ($uid === '') { throw new DceSecurityException( 'Unable to get a user identifier using the system DCE ' . 'Security provider; please provide a custom identifier or ' . 'use a different provider' ); } $uid = new IntegerObject($uid); return $uid; } /** * @throws DceSecurityException if unable to get a group identifier * * @inheritDoc */ public function getGid(): IntegerObject { /** @var int|float|string|IntegerObject|null $gid */ static $gid = null; if ($gid instanceof IntegerObject) { return $gid; } if ($gid === null) { $gid = $this->getSystemGid(); } if ($gid === '') { throw new DceSecurityException( 'Unable to get a group identifier using the system DCE ' . 'Security provider; please provide a custom identifier or ' . 'use a different provider' ); } $gid = new IntegerObject($gid); return $gid; } /** * Returns the UID from the system */ private function getSystemUid(): string { if (!$this->hasShellExec()) { return ''; } return match ($this->getOs()) { 'WIN' => $this->getWindowsUid(), default => trim((string) shell_exec('id -u')), }; } /** * Returns the GID from the system */ private function getSystemGid(): string { if (!$this->hasShellExec()) { return ''; } return match ($this->getOs()) { 'WIN' => $this->getWindowsGid(), default => trim((string) shell_exec('id -g')), }; } /** * Returns true if shell_exec() is available for use */ private function hasShellExec(): bool { $disabledFunctions = strtolower((string) ini_get('disable_functions')); return !str_contains($disabledFunctions, 'shell_exec'); } /** * Returns the PHP_OS string */ private function getOs(): string { /** * @psalm-suppress UnnecessaryVarAnnotation * @var string $phpOs */ $phpOs = constant('PHP_OS'); return strtoupper(substr($phpOs, 0, 3)); } /** * Returns the user identifier for a user on a Windows system * * Windows does not have the same concept as an effective POSIX UID for the * running script. Instead, each user is uniquely identified by an SID * (security identifier). The SID includes three 32-bit unsigned integers * that make up a unique domain identifier, followed by an RID (relative * identifier) that we will use as the UID. The primary caveat is that this * UID may not be unique to the system, since it is, instead, unique to the * domain. * * @link https://www.lifewire.com/what-is-an-sid-number-2626005 What Is an SID Number? * @link https://bit.ly/30vE7NM Well-known SID Structures * @link https://bit.ly/2FWcYKJ Well-known security identifiers in Windows operating systems * @link https://www.windows-commandline.com/get-sid-of-user/ Get SID of user */ private function getWindowsUid(): string { $response = shell_exec('whoami /user /fo csv /nh'); if ($response === null) { return ''; } $sid = str_getcsv(trim((string) $response))[1] ?? ''; if (($lastHyphen = strrpos($sid, '-')) === false) { return ''; } return trim(substr($sid, $lastHyphen + 1)); } /** * Returns a group identifier for a user on a Windows system * * Since Windows does not have the same concept as an effective POSIX GID * for the running script, we will get the local group memberships for the * user running the script. Then, we will get the SID (security identifier) * for the first group that appears in that list. Finally, we will return * the RID (relative identifier) for the group and use that as the GID. * * @link https://www.windows-commandline.com/list-of-user-groups-command-line/ List of user groups command line */ private function getWindowsGid(): string { $response = shell_exec('net user %username% | findstr /b /i "Local Group Memberships"'); if ($response === null) { return ''; } /** @var string[] $userGroups */ $userGroups = preg_split('/\s{2,}/', (string) $response, -1, PREG_SPLIT_NO_EMPTY); $firstGroup = trim($userGroups[1] ?? '', "* \t\n\r\0\x0B"); if ($firstGroup === '') { return ''; } $response = shell_exec('wmic group get name,sid | findstr /b /i ' . escapeshellarg($firstGroup)); if ($response === null) { return ''; } /** @var string[] $userGroup */ $userGroup = preg_split('/\s{2,}/', (string) $response, -1, PREG_SPLIT_NO_EMPTY); $sid = $userGroup[1] ?? ''; if (($lastHyphen = strrpos($sid, '-')) === false) { return ''; } return trim(substr($sid, $lastHyphen + 1)); } } PK ! w�k6Z Z ( Provider/Node/NodeProviderCollection.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Provider\Node; use Ramsey\Collection\AbstractCollection; use Ramsey\Uuid\Provider\NodeProviderInterface; use Ramsey\Uuid\Type\Hexadecimal; /** * A collection of NodeProviderInterface objects * * @deprecated this class has been deprecated, and will be removed in 5.0.0. The use-case for this class comes from * a pre-`phpstan/phpstan` and pre-`vimeo/psalm` ecosystem, in which type safety had to be mostly enforced * at runtime: that is no longer necessary, now that you can safely verify your code to be correct, and use * more generic types like `iterable<T>` instead. * * @extends AbstractCollection<NodeProviderInterface> */ class NodeProviderCollection extends AbstractCollection { public function getType(): string { return NodeProviderInterface::class; } /** * Re-constructs the object from its serialized form * * @param string $serialized The serialized PHP string to unserialize into * a UuidInterface instance * * @phpcsSuppress SlevomatCodingStandard.TypeHints.ParameterTypeHint.MissingNativeTypeHint * @psalm-suppress RedundantConditionGivenDocblockType */ public function unserialize($serialized): void { /** @var array<array-key, NodeProviderInterface> $data */ $data = unserialize($serialized, [ 'allowed_classes' => [ Hexadecimal::class, RandomNodeProvider::class, StaticNodeProvider::class, SystemNodeProvider::class, ], ]); $this->data = array_filter( $data, function ($unserialized): bool { return $unserialized instanceof NodeProviderInterface; } ); } } PK ! �Co%X X $ Provider/Node/StaticNodeProvider.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Provider\Node; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Provider\NodeProviderInterface; use Ramsey\Uuid\Type\Hexadecimal; use function dechex; use function hexdec; use function str_pad; use function substr; use const STR_PAD_LEFT; /** * StaticNodeProvider provides a static node value with the multicast bit set * * @link http://tools.ietf.org/html/rfc4122#section-4.5 RFC 4122, § 4.5: Node IDs that Do Not Identify the Host */ class StaticNodeProvider implements NodeProviderInterface { private Hexadecimal $node; /** * @param Hexadecimal $node The static node value to use */ public function __construct(Hexadecimal $node) { if (strlen($node->toString()) > 12) { throw new InvalidArgumentException( 'Static node value cannot be greater than 12 hexadecimal characters' ); } $this->node = $this->setMulticastBit($node); } public function getNode(): Hexadecimal { return $this->node; } /** * Set the multicast bit for the static node value */ private function setMulticastBit(Hexadecimal $node): Hexadecimal { $nodeHex = str_pad($node->toString(), 12, '0', STR_PAD_LEFT); $firstOctet = substr($nodeHex, 0, 2); $firstOctet = str_pad( dechex(hexdec($firstOctet) | 0x01), 2, '0', STR_PAD_LEFT ); return new Hexadecimal($firstOctet . substr($nodeHex, 2)); } } PK ! �M��a a & Provider/Node/FallbackNodeProvider.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Provider\Node; use Ramsey\Uuid\Exception\NodeException; use Ramsey\Uuid\Provider\NodeProviderInterface; use Ramsey\Uuid\Type\Hexadecimal; /** * FallbackNodeProvider retrieves the system node ID by stepping through a list * of providers until a node ID can be obtained */ class FallbackNodeProvider implements NodeProviderInterface { /** * @param iterable<NodeProviderInterface> $providers Array of node providers */ public function __construct(private iterable $providers) { } public function getNode(): Hexadecimal { $lastProviderException = null; foreach ($this->providers as $provider) { try { return $provider->getNode(); } catch (NodeException $exception) { $lastProviderException = $exception; continue; } } throw new NodeException( 'Unable to find a suitable node provider', 0, $lastProviderException ); } } PK ! �� � $ Provider/Node/RandomNodeProvider.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Provider\Node; use Ramsey\Uuid\Exception\RandomSourceException; use Ramsey\Uuid\Provider\NodeProviderInterface; use Ramsey\Uuid\Type\Hexadecimal; use Throwable; use function bin2hex; use function dechex; use function hex2bin; use function hexdec; use function str_pad; use function substr; use const STR_PAD_LEFT; /** * RandomNodeProvider generates a random node ID * * @link http://tools.ietf.org/html/rfc4122#section-4.5 RFC 4122, § 4.5: Node IDs that Do Not Identify the Host */ class RandomNodeProvider implements NodeProviderInterface { public function getNode(): Hexadecimal { try { $nodeBytes = random_bytes(6); } catch (Throwable $exception) { throw new RandomSourceException( $exception->getMessage(), (int) $exception->getCode(), $exception ); } // Split the node bytes for math on 32-bit systems. $nodeMsb = substr($nodeBytes, 0, 3); $nodeLsb = substr($nodeBytes, 3); // Set the multicast bit; see RFC 4122, section 4.5. $nodeMsb = hex2bin( str_pad( dechex(hexdec(bin2hex($nodeMsb)) | 0x010000), 6, '0', STR_PAD_LEFT ) ); // Recombine the node bytes. $node = $nodeMsb . $nodeLsb; return new Hexadecimal(str_pad(bin2hex($node), 12, '0', STR_PAD_LEFT)); } } PK ! �}1T� � $ Provider/Node/SystemNodeProvider.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Provider\Node; use Ramsey\Uuid\Exception\NodeException; use Ramsey\Uuid\Provider\NodeProviderInterface; use Ramsey\Uuid\Type\Hexadecimal; use function array_filter; use function array_map; use function array_walk; use function count; use function ob_get_clean; use function ob_start; use function preg_match; use function preg_match_all; use function reset; use function str_contains; use function str_replace; use function strtolower; use function strtoupper; use function substr; use const GLOB_NOSORT; use const PREG_PATTERN_ORDER; /** * SystemNodeProvider retrieves the system node ID, if possible * * The system node ID, or host ID, is often the same as the MAC address for a * network interface on the host. */ class SystemNodeProvider implements NodeProviderInterface { /** * Pattern to match nodes in ifconfig and ipconfig output. */ private const IFCONFIG_PATTERN = '/[^:]([0-9a-f]{2}([:-])[0-9a-f]{2}(\2[0-9a-f]{2}){4})[^:]/i'; /** * Pattern to match nodes in sysfs stream output. */ private const SYSFS_PATTERN = '/^([0-9a-f]{2}:){5}[0-9a-f]{2}$/i'; public function getNode(): Hexadecimal { $node = $this->getNodeFromSystem(); if ($node === '') { throw new NodeException( 'Unable to fetch a node for this system' ); } return new Hexadecimal($node); } /** * Returns the system node, if it can find it */ protected function getNodeFromSystem(): string { static $node = null; if ($node !== null) { return (string) $node; } // First, try a Linux-specific approach. $node = $this->getSysfs(); if ($node === '') { // Search ifconfig output for MAC addresses & return the first one. $node = $this->getIfconfig(); } $node = str_replace([':', '-'], '', $node); return $node; } /** * Returns the network interface configuration for the system * * @codeCoverageIgnore */ protected function getIfconfig(): string { $disabledFunctions = strtolower((string) ini_get('disable_functions')); if (str_contains($disabledFunctions, 'passthru')) { return ''; } /** * @psalm-suppress UnnecessaryVarAnnotation * @var string $phpOs */ $phpOs = constant('PHP_OS'); ob_start(); switch (strtoupper(substr($phpOs, 0, 3))) { case 'WIN': passthru('ipconfig /all 2>&1'); break; case 'DAR': passthru('ifconfig 2>&1'); break; case 'FRE': passthru('netstat -i -f link 2>&1'); break; case 'LIN': default: passthru('netstat -ie 2>&1'); break; } $ifconfig = (string) ob_get_clean(); if (preg_match_all(self::IFCONFIG_PATTERN, $ifconfig, $matches, PREG_PATTERN_ORDER)) { foreach ($matches[1] as $iface) { if ($iface !== '00:00:00:00:00:00' && $iface !== '00-00-00-00-00-00') { return $iface; } } } return ''; } /** * Returns MAC address from the first system interface via the sysfs interface */ protected function getSysfs(): string { $mac = ''; /** * @psalm-suppress UnnecessaryVarAnnotation * @var string $phpOs */ $phpOs = constant('PHP_OS'); if (strtoupper($phpOs) === 'LINUX') { $addressPaths = glob('/sys/class/net/*/address', GLOB_NOSORT); if ($addressPaths === false || count($addressPaths) === 0) { return ''; } /** @var array<array-key, string> $macs */ $macs = []; array_walk($addressPaths, function (string $addressPath) use (&$macs): void { if (is_readable($addressPath)) { $macs[] = file_get_contents($addressPath); } }); /** @var callable $trim */ $trim = 'trim'; $macs = array_map($trim, $macs); // Remove invalid entries. $macs = array_filter($macs, function (string $address) { return $address !== '00:00:00:00:00:00' && preg_match(self::SYSFS_PATTERN, $address); }); /** @var string|bool $mac */ $mac = reset($macs); } return (string) $mac; } } PK ! d� � � ) Provider/DceSecurityProviderInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Provider; use Ramsey\Uuid\Rfc4122\UuidV2; use Ramsey\Uuid\Type\Integer as IntegerObject; /** * A DCE provider provides access to local domain identifiers for version 2, * DCE Security, UUIDs * * @see UuidV2 */ interface DceSecurityProviderInterface { /** * Returns a user identifier for the system * * @link https://en.wikipedia.org/wiki/User_identifier User identifier */ public function getUid(): IntegerObject; /** * Returns a group identifier for the system * * @link https://en.wikipedia.org/wiki/Group_identifier Group identifier */ public function getGid(): IntegerObject; } PK ! 'U�UL L Builder/DegradedUuidBuilder.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Builder; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\Time\DegradedTimeConverter; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\DegradedUuid; use Ramsey\Uuid\Rfc4122\Fields as Rfc4122Fields; use Ramsey\Uuid\UuidInterface; /** * @deprecated DegradedUuid instances are no longer necessary to support 32-bit * systems. Transition to {@see DefaultUuidBuilder}. * * @psalm-immutable */ class DegradedUuidBuilder implements UuidBuilderInterface { private TimeConverterInterface $timeConverter; /** * @param NumberConverterInterface $numberConverter The number converter to * use when constructing the DegradedUuid * @param TimeConverterInterface|null $timeConverter The time converter to use * for converting timestamps extracted from a UUID to Unix timestamps */ public function __construct( private NumberConverterInterface $numberConverter, ?TimeConverterInterface $timeConverter = null ) { $this->timeConverter = $timeConverter ?: new DegradedTimeConverter(); } /** * Builds and returns a DegradedUuid * * @param CodecInterface $codec The codec to use for building this DegradedUuid instance * @param string $bytes The byte string from which to construct a UUID * * @return DegradedUuid The DegradedUuidBuild returns an instance of Ramsey\Uuid\DegradedUuid * * @psalm-pure */ public function build(CodecInterface $codec, string $bytes): UuidInterface { return new DegradedUuid( new Rfc4122Fields($bytes), $this->numberConverter, $codec, $this->timeConverter ); } } PK ! �'�m m Builder/FallbackBuilder.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Builder; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Exception\BuilderNotFoundException; use Ramsey\Uuid\Exception\UnableToBuildUuidException; use Ramsey\Uuid\UuidInterface; /** * FallbackBuilder builds a UUID by stepping through a list of UUID builders * until a UUID can be constructed without exceptions * * @psalm-immutable */ class FallbackBuilder implements UuidBuilderInterface { /** * @param iterable<UuidBuilderInterface> $builders An array of UUID builders */ public function __construct(private iterable $builders) { } /** * Builds and returns a UuidInterface instance using the first builder that * succeeds * * @param CodecInterface $codec The codec to use for building this instance * @param string $bytes The byte string from which to construct a UUID * * @return UuidInterface an instance of a UUID object * * @psalm-pure */ public function build(CodecInterface $codec, string $bytes): UuidInterface { $lastBuilderException = null; foreach ($this->builders as $builder) { try { return $builder->build($codec, $bytes); } catch (UnableToBuildUuidException $exception) { $lastBuilderException = $exception; continue; } } throw new BuilderNotFoundException( 'Could not find a suitable builder for the provided codec and fields', 0, $lastBuilderException ); } } PK ! .�� Builder/UuidBuilderInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Builder; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\UuidInterface; /** * A UUID builder builds instances of UuidInterface * * @psalm-immutable */ interface UuidBuilderInterface { /** * Builds and returns a UuidInterface * * @param CodecInterface $codec The codec to use for building this UuidInterface instance * @param string $bytes The byte string from which to construct a UUID * * @return UuidInterface Implementations may choose to return more specific * instances of UUIDs that implement UuidInterface * * @psalm-pure */ public function build(CodecInterface $codec, string $bytes): UuidInterface; } PK ! S�G � � Builder/BuilderCollection.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Builder; use Ramsey\Collection\AbstractCollection; use Ramsey\Uuid\Converter\Number\GenericNumberConverter; use Ramsey\Uuid\Converter\Time\GenericTimeConverter; use Ramsey\Uuid\Converter\Time\PhpTimeConverter; use Ramsey\Uuid\Guid\GuidBuilder; use Ramsey\Uuid\Math\BrickMathCalculator; use Ramsey\Uuid\Nonstandard\UuidBuilder as NonstandardUuidBuilder; use Ramsey\Uuid\Rfc4122\UuidBuilder as Rfc4122UuidBuilder; use Traversable; /** * A collection of UuidBuilderInterface objects * * @deprecated this class has been deprecated, and will be removed in 5.0.0. The use-case for this class comes from * a pre-`phpstan/phpstan` and pre-`vimeo/psalm` ecosystem, in which type safety had to be mostly enforced * at runtime: that is no longer necessary, now that you can safely verify your code to be correct, and use * more generic types like `iterable<T>` instead. * * @extends AbstractCollection<UuidBuilderInterface> */ class BuilderCollection extends AbstractCollection { public function getType(): string { return UuidBuilderInterface::class; } /** * @psalm-mutation-free * @psalm-suppress ImpureMethodCall * @psalm-suppress InvalidTemplateParam */ public function getIterator(): Traversable { return parent::getIterator(); } /** * Re-constructs the object from its serialized form * * @param string $serialized The serialized PHP string to unserialize into * a UuidInterface instance * * @phpcsSuppress SlevomatCodingStandard.TypeHints.ParameterTypeHint.MissingNativeTypeHint * @psalm-suppress RedundantConditionGivenDocblockType */ public function unserialize($serialized): void { /** @var array<array-key, UuidBuilderInterface> $data */ $data = unserialize($serialized, [ 'allowed_classes' => [ BrickMathCalculator::class, GenericNumberConverter::class, GenericTimeConverter::class, GuidBuilder::class, NonstandardUuidBuilder::class, PhpTimeConverter::class, Rfc4122UuidBuilder::class, ], ]); $this->data = array_filter( $data, function ($unserialized): bool { return $unserialized instanceof UuidBuilderInterface; } ); } } PK ! 6�� 8 8 Builder/DefaultUuidBuilder.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Builder; use Ramsey\Uuid\Rfc4122\UuidBuilder as Rfc4122UuidBuilder; /** * @deprecated Transition to {@see Rfc4122UuidBuilder}. * * @psalm-immutable */ class DefaultUuidBuilder extends Rfc4122UuidBuilder { } PK ! �j� � Guid/GuidBuilder.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Guid; use Ramsey\Uuid\Builder\UuidBuilderInterface; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Exception\UnableToBuildUuidException; use Ramsey\Uuid\UuidInterface; use Throwable; /** * GuidBuilder builds instances of Guid * * @see Guid * * @psalm-immutable */ class GuidBuilder implements UuidBuilderInterface { /** * @param NumberConverterInterface $numberConverter The number converter to * use when constructing the Guid * @param TimeConverterInterface $timeConverter The time converter to use * for converting timestamps extracted from a UUID to Unix timestamps */ public function __construct( private NumberConverterInterface $numberConverter, private TimeConverterInterface $timeConverter ) { } /** * Builds and returns a Guid * * @param CodecInterface $codec The codec to use for building this Guid instance * @param string $bytes The byte string from which to construct a UUID * * @return Guid The GuidBuilder returns an instance of Ramsey\Uuid\Guid\Guid * * @psalm-pure */ public function build(CodecInterface $codec, string $bytes): UuidInterface { try { return new Guid( $this->buildFields($bytes), $this->numberConverter, $codec, $this->timeConverter ); } catch (Throwable $e) { throw new UnableToBuildUuidException($e->getMessage(), (int) $e->getCode(), $e); } } /** * Proxy method to allow injecting a mock, for testing */ protected function buildFields(string $bytes): Fields { return new Fields($bytes); } } PK ! ·o[ [ Guid/Fields.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Guid; use Ramsey\Uuid\Exception\InvalidArgumentException; use Ramsey\Uuid\Fields\SerializableFieldsTrait; use Ramsey\Uuid\Rfc4122\FieldsInterface; use Ramsey\Uuid\Rfc4122\MaxTrait; use Ramsey\Uuid\Rfc4122\NilTrait; use Ramsey\Uuid\Rfc4122\VariantTrait; use Ramsey\Uuid\Rfc4122\VersionTrait; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Uuid; use function bin2hex; use function dechex; use function hexdec; use function pack; use function sprintf; use function str_pad; use function strlen; use function substr; use function unpack; use const STR_PAD_LEFT; /** * GUIDs are comprised of a set of named fields, according to RFC 4122 * * @see Guid * * @psalm-immutable */ final class Fields implements FieldsInterface { use MaxTrait; use NilTrait; use SerializableFieldsTrait; use VariantTrait; use VersionTrait; /** * @param string $bytes A 16-byte binary string representation of a UUID * * @throws InvalidArgumentException if the byte string is not exactly 16 bytes * @throws InvalidArgumentException if the byte string does not represent a GUID * @throws InvalidArgumentException if the byte string does not contain a valid version */ public function __construct(private string $bytes) { if (strlen($this->bytes) !== 16) { throw new InvalidArgumentException( 'The byte string must be 16 bytes long; ' . 'received ' . strlen($this->bytes) . ' bytes' ); } if (!$this->isCorrectVariant()) { throw new InvalidArgumentException( 'The byte string received does not conform to the RFC ' . '4122 or Microsoft Corporation variants' ); } if (!$this->isCorrectVersion()) { throw new InvalidArgumentException( 'The byte string received does not contain a valid version' ); } } public function getBytes(): string { return $this->bytes; } public function getTimeLow(): Hexadecimal { // Swap the bytes from little endian to network byte order. /** @var array $hex */ $hex = unpack( 'H*', pack( 'v*', hexdec(bin2hex(substr($this->bytes, 2, 2))), hexdec(bin2hex(substr($this->bytes, 0, 2))) ) ); return new Hexadecimal((string) ($hex[1] ?? '')); } public function getTimeMid(): Hexadecimal { // Swap the bytes from little endian to network byte order. /** @var array $hex */ $hex = unpack( 'H*', pack( 'v', hexdec(bin2hex(substr($this->bytes, 4, 2))) ) ); return new Hexadecimal((string) ($hex[1] ?? '')); } public function getTimeHiAndVersion(): Hexadecimal { // Swap the bytes from little endian to network byte order. /** @var array $hex */ $hex = unpack( 'H*', pack( 'v', hexdec(bin2hex(substr($this->bytes, 6, 2))) ) ); return new Hexadecimal((string) ($hex[1] ?? '')); } public function getTimestamp(): Hexadecimal { return new Hexadecimal(sprintf( '%03x%04s%08s', hexdec($this->getTimeHiAndVersion()->toString()) & 0x0fff, $this->getTimeMid()->toString(), $this->getTimeLow()->toString() )); } public function getClockSeq(): Hexadecimal { if ($this->isMax()) { $clockSeq = 0xffff; } elseif ($this->isNil()) { $clockSeq = 0x0000; } else { $clockSeq = hexdec(bin2hex(substr($this->bytes, 8, 2))) & 0x3fff; } return new Hexadecimal(str_pad(dechex($clockSeq), 4, '0', STR_PAD_LEFT)); } public function getClockSeqHiAndReserved(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 8, 1))); } public function getClockSeqLow(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 9, 1))); } public function getNode(): Hexadecimal { return new Hexadecimal(bin2hex(substr($this->bytes, 10))); } public function getVersion(): ?int { if ($this->isNil() || $this->isMax()) { return null; } /** @var array $parts */ $parts = unpack('n*', $this->bytes); return ((int) $parts[4] >> 4) & 0x00f; } private function isCorrectVariant(): bool { if ($this->isNil() || $this->isMax()) { return true; } $variant = $this->getVariant(); return $variant === Uuid::RFC_4122 || $variant === Uuid::RESERVED_MICROSOFT; } } PK ! �o� � Guid/Guid.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid\Guid; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Uuid; /** * Guid represents a UUID with "native" (little-endian) byte order * * From Wikipedia: * * > The first three fields are unsigned 32- and 16-bit integers and are subject * > to swapping, while the last two fields consist of uninterpreted bytes, not * > subject to swapping. This byte swapping applies even for versions 3, 4, and * > 5, where the canonical fields do not correspond to the content of the UUID. * * The first three fields of a GUID are encoded in little-endian byte order, * while the last three fields are in network (big-endian) byte order. This is * according to the history of the Microsoft definition of a GUID. * * According to the .NET Guid.ToByteArray method documentation: * * > Note that the order of bytes in the returned byte array is different from * > the string representation of a Guid value. The order of the beginning * > four-byte group and the next two two-byte groups is reversed, whereas the * > order of the last two-byte group and the closing six-byte group is the * > same. * * @link https://en.wikipedia.org/wiki/Universally_unique_identifier#Variants UUID Variants on Wikipedia * @link https://docs.microsoft.com/en-us/windows/win32/api/guiddef/ns-guiddef-guid Windows GUID structure * @link https://docs.microsoft.com/en-us/dotnet/api/system.guid .NET Guid Struct * @link https://docs.microsoft.com/en-us/dotnet/api/system.guid.tobytearray .NET Guid.ToByteArray Method * * @psalm-immutable */ final class Guid extends Uuid { public function __construct( Fields $fields, NumberConverterInterface $numberConverter, CodecInterface $codec, TimeConverterInterface $timeConverter ) { parent::__construct($fields, $numberConverter, $codec, $timeConverter); } } PK ! �<f��= �= UuidFactory.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid; use DateTimeInterface; use Ramsey\Uuid\Builder\UuidBuilderInterface; use Ramsey\Uuid\Codec\CodecInterface; use Ramsey\Uuid\Converter\NumberConverterInterface; use Ramsey\Uuid\Converter\TimeConverterInterface; use Ramsey\Uuid\Generator\DceSecurityGeneratorInterface; use Ramsey\Uuid\Generator\DefaultTimeGenerator; use Ramsey\Uuid\Generator\NameGeneratorInterface; use Ramsey\Uuid\Generator\RandomGeneratorInterface; use Ramsey\Uuid\Generator\TimeGeneratorInterface; use Ramsey\Uuid\Generator\UnixTimeGenerator; use Ramsey\Uuid\Lazy\LazyUuidFromString; use Ramsey\Uuid\Provider\NodeProviderInterface; use Ramsey\Uuid\Provider\Time\FixedTimeProvider; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; use Ramsey\Uuid\Type\Time; use Ramsey\Uuid\Validator\ValidatorInterface; use function bin2hex; use function hex2bin; use function pack; use function str_pad; use function strtolower; use function substr; use function substr_replace; use function unpack; use const STR_PAD_LEFT; class UuidFactory implements UuidFactoryInterface { private CodecInterface $codec; private DceSecurityGeneratorInterface $dceSecurityGenerator; private NameGeneratorInterface $nameGenerator; private NodeProviderInterface $nodeProvider; private NumberConverterInterface $numberConverter; private RandomGeneratorInterface $randomGenerator; private TimeConverterInterface $timeConverter; private TimeGeneratorInterface $timeGenerator; private TimeGeneratorInterface $unixTimeGenerator; private UuidBuilderInterface $uuidBuilder; private ValidatorInterface $validator; /** * @var bool whether the feature set was provided from outside, or we can * operate under "default" assumptions */ private bool $isDefaultFeatureSet; /** * @param FeatureSet|null $features A set of available features in the current environment */ public function __construct(?FeatureSet $features = null) { $this->isDefaultFeatureSet = $features === null; $features = $features ?: new FeatureSet(); $this->codec = $features->getCodec(); $this->dceSecurityGenerator = $features->getDceSecurityGenerator(); $this->nameGenerator = $features->getNameGenerator(); $this->nodeProvider = $features->getNodeProvider(); $this->numberConverter = $features->getNumberConverter(); $this->randomGenerator = $features->getRandomGenerator(); $this->timeConverter = $features->getTimeConverter(); $this->timeGenerator = $features->getTimeGenerator(); $this->uuidBuilder = $features->getBuilder(); $this->validator = $features->getValidator(); $this->unixTimeGenerator = $features->getUnixTimeGenerator(); } /** * Returns the codec used by this factory */ public function getCodec(): CodecInterface { return $this->codec; } /** * Sets the codec to use for this factory * * @param CodecInterface $codec A UUID encoder-decoder */ public function setCodec(CodecInterface $codec): void { $this->isDefaultFeatureSet = false; $this->codec = $codec; } /** * Returns the name generator used by this factory */ public function getNameGenerator(): NameGeneratorInterface { return $this->nameGenerator; } /** * Sets the name generator to use for this factory * * @param NameGeneratorInterface $nameGenerator A generator to generate * binary data, based on a namespace and name */ public function setNameGenerator(NameGeneratorInterface $nameGenerator): void { $this->isDefaultFeatureSet = false; $this->nameGenerator = $nameGenerator; } /** * Returns the node provider used by this factory */ public function getNodeProvider(): NodeProviderInterface { return $this->nodeProvider; } /** * Returns the random generator used by this factory */ public function getRandomGenerator(): RandomGeneratorInterface { return $this->randomGenerator; } /** * Returns the time generator used by this factory */ public function getTimeGenerator(): TimeGeneratorInterface { return $this->timeGenerator; } /** * Sets the time generator to use for this factory * * @param TimeGeneratorInterface $generator A generator to generate binary * data, based on the time */ public function setTimeGenerator(TimeGeneratorInterface $generator): void { $this->isDefaultFeatureSet = false; $this->timeGenerator = $generator; } /** * Returns the DCE Security generator used by this factory */ public function getDceSecurityGenerator(): DceSecurityGeneratorInterface { return $this->dceSecurityGenerator; } /** * Sets the DCE Security generator to use for this factory * * @param DceSecurityGeneratorInterface $generator A generator to generate * binary data, based on a local domain and local identifier */ public function setDceSecurityGenerator(DceSecurityGeneratorInterface $generator): void { $this->isDefaultFeatureSet = false; $this->dceSecurityGenerator = $generator; } /** * Returns the number converter used by this factory */ public function getNumberConverter(): NumberConverterInterface { return $this->numberConverter; } /** * Sets the random generator to use for this factory * * @param RandomGeneratorInterface $generator A generator to generate binary * data, based on some random input */ public function setRandomGenerator(RandomGeneratorInterface $generator): void { $this->isDefaultFeatureSet = false; $this->randomGenerator = $generator; } /** * Sets the number converter to use for this factory * * @param NumberConverterInterface $converter A converter to use for working * with large integers (i.e. integers greater than PHP_INT_MAX) */ public function setNumberConverter(NumberConverterInterface $converter): void { $this->isDefaultFeatureSet = false; $this->numberConverter = $converter; } /** * Returns the UUID builder used by this factory */ public function getUuidBuilder(): UuidBuilderInterface { return $this->uuidBuilder; } /** * Sets the UUID builder to use for this factory * * @param UuidBuilderInterface $builder A builder for constructing instances * of UuidInterface */ public function setUuidBuilder(UuidBuilderInterface $builder): void { $this->isDefaultFeatureSet = false; $this->uuidBuilder = $builder; } /** * @psalm-mutation-free */ public function getValidator(): ValidatorInterface { return $this->validator; } /** * Sets the validator to use for this factory * * @param ValidatorInterface $validator A validator to use for validating * whether a string is a valid UUID */ public function setValidator(ValidatorInterface $validator): void { $this->isDefaultFeatureSet = false; $this->validator = $validator; } /** * @psalm-pure */ public function fromBytes(string $bytes): UuidInterface { return $this->codec->decodeBytes($bytes); } /** * @psalm-pure */ public function fromString(string $uuid): UuidInterface { $uuid = strtolower($uuid); return $this->codec->decode($uuid); } /** * @psalm-pure */ public function fromInteger(string $integer): UuidInterface { $hex = $this->numberConverter->toHex($integer); $hex = str_pad($hex, 32, '0', STR_PAD_LEFT); return $this->fromString($hex); } public function fromDateTime( DateTimeInterface $dateTime, ?Hexadecimal $node = null, ?int $clockSeq = null ): UuidInterface { $timeProvider = new FixedTimeProvider( new Time($dateTime->format('U'), $dateTime->format('u')) ); $timeGenerator = new DefaultTimeGenerator( $this->nodeProvider, $this->timeConverter, $timeProvider ); $nodeHex = $node ? $node->toString() : null; $bytes = $timeGenerator->generate($nodeHex, $clockSeq); return $this->uuidFromBytesAndVersion($bytes, Uuid::UUID_TYPE_TIME); } /** * @psalm-pure */ public function fromHexadecimal(Hexadecimal $hex): UuidInterface { return $this->codec->decode($hex->__toString()); } /** * @inheritDoc */ public function uuid1($node = null, ?int $clockSeq = null): UuidInterface { $bytes = $this->timeGenerator->generate($node, $clockSeq); return $this->uuidFromBytesAndVersion($bytes, Uuid::UUID_TYPE_TIME); } public function uuid2( int $localDomain, ?IntegerObject $localIdentifier = null, ?Hexadecimal $node = null, ?int $clockSeq = null ): UuidInterface { $bytes = $this->dceSecurityGenerator->generate( $localDomain, $localIdentifier, $node, $clockSeq ); return $this->uuidFromBytesAndVersion($bytes, Uuid::UUID_TYPE_DCE_SECURITY); } /** * @inheritDoc * @psalm-pure */ public function uuid3($ns, string $name): UuidInterface { return $this->uuidFromNsAndName($ns, $name, Uuid::UUID_TYPE_HASH_MD5, 'md5'); } public function uuid4(): UuidInterface { $bytes = $this->randomGenerator->generate(16); return $this->uuidFromBytesAndVersion($bytes, Uuid::UUID_TYPE_RANDOM); } /** * @inheritDoc * @psalm-pure */ public function uuid5($ns, string $name): UuidInterface { return $this->uuidFromNsAndName($ns, $name, Uuid::UUID_TYPE_HASH_SHA1, 'sha1'); } public function uuid6(?Hexadecimal $node = null, ?int $clockSeq = null): UuidInterface { $nodeHex = $node ? $node->toString() : null; $bytes = $this->timeGenerator->generate($nodeHex, $clockSeq); // Rearrange the bytes, according to the UUID version 6 specification. $v6 = $bytes[6] . $bytes[7] . $bytes[4] . $bytes[5] . $bytes[0] . $bytes[1] . $bytes[2] . $bytes[3]; $v6 = bin2hex($v6); // Drop the first four bits, while adding an empty four bits for the // version field. This allows us to reconstruct the correct time from // the bytes of this UUID. $v6Bytes = hex2bin(substr($v6, 1, 12) . '0' . substr($v6, -3)); $v6Bytes .= substr($bytes, 8); return $this->uuidFromBytesAndVersion($v6Bytes, Uuid::UUID_TYPE_REORDERED_TIME); } /** * Returns a version 7 (Unix Epoch time) UUID * * @param DateTimeInterface|null $dateTime An optional date/time from which * to create the version 7 UUID. If not provided, the UUID is generated * using the current date/time. * * @return UuidInterface A UuidInterface instance that represents a * version 7 UUID */ public function uuid7(?DateTimeInterface $dateTime = null): UuidInterface { assert($this->unixTimeGenerator instanceof UnixTimeGenerator); $bytes = $this->unixTimeGenerator->generate(null, null, $dateTime); return $this->uuidFromBytesAndVersion($bytes, Uuid::UUID_TYPE_UNIX_TIME); } /** * Returns a version 8 (Custom) UUID * * The bytes provided may contain any value according to your application's * needs. Be aware, however, that other applications may not understand the * semantics of the value. * * @param string $bytes A 16-byte octet string. This is an open blob * of data that you may fill with 128 bits of information. Be aware, * however, bits 48 through 51 will be replaced with the UUID version * field, and bits 64 and 65 will be replaced with the UUID variant. You * MUST NOT rely on these bits for your application needs. * * @return UuidInterface A UuidInterface instance that represents a * version 8 UUID */ public function uuid8(string $bytes): UuidInterface { return $this->uuidFromBytesAndVersion($bytes, Uuid::UUID_TYPE_CUSTOM); } /** * Returns a Uuid created from the provided byte string * * Uses the configured builder and codec and the provided byte string to * construct a Uuid object. * * @param string $bytes The byte string from which to construct a UUID * * @return UuidInterface An instance of UuidInterface, created from the * provided bytes * * @psalm-pure */ public function uuid(string $bytes): UuidInterface { /** @psalm-suppress ImpurePropertyFetch */ return $this->uuidBuilder->build($this->codec, $bytes); } /** * Returns a version 3 or 5 namespaced Uuid * * @param string|UuidInterface $ns The namespace (must be a valid UUID) * @param string $name The name to hash together with the namespace * @param int $version The version of UUID to create (3 or 5) * @param string $hashAlgorithm The hashing algorithm to use when hashing * together the namespace and name * * @return UuidInterface An instance of UuidInterface, created by hashing * together the provided namespace and name * * @psalm-pure */ private function uuidFromNsAndName( UuidInterface | string $ns, string $name, int $version, string $hashAlgorithm ): UuidInterface { if (!($ns instanceof UuidInterface)) { $ns = $this->fromString($ns); } $bytes = $this->nameGenerator->generate($ns, $name, $hashAlgorithm); return $this->uuidFromBytesAndVersion(substr($bytes, 0, 16), $version); } /** * Returns an RFC 4122 variant Uuid, created from the provided bytes and version * * @param string $bytes The byte string to convert to a UUID * @param int $version The RFC 4122 version to apply to the UUID * * @return UuidInterface An instance of UuidInterface, created from the * byte string and version * * @psalm-pure */ private function uuidFromBytesAndVersion(string $bytes, int $version): UuidInterface { /** @var array $unpackedTime */ $unpackedTime = unpack('n*', substr($bytes, 6, 2)); $timeHi = (int) $unpackedTime[1]; $timeHiAndVersion = pack('n*', BinaryUtils::applyVersion($timeHi, $version)); /** @var array $unpackedClockSeq */ $unpackedClockSeq = unpack('n*', substr($bytes, 8, 2)); $clockSeqHi = (int) $unpackedClockSeq[1]; $clockSeqHiAndReserved = pack('n*', BinaryUtils::applyVariant($clockSeqHi)); $bytes = substr_replace($bytes, $timeHiAndVersion, 6, 2); $bytes = substr_replace($bytes, $clockSeqHiAndReserved, 8, 2); if ($this->isDefaultFeatureSet) { return LazyUuidFromString::fromBytes($bytes); } /** @psalm-suppress ImpureVariable */ return $this->uuid($bytes); } } PK ! i��� UuidInterface.phpnu ȯ�� <?php /** * This file is part of the ramsey/uuid library * * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. * * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com> * @license http://opensource.org/licenses/MIT MIT */ declare(strict_types=1); namespace Ramsey\Uuid; use JsonSerializable; use Ramsey\Uuid\Fields\FieldsInterface; use Ramsey\Uuid\Type\Hexadecimal; use Ramsey\Uuid\Type\Integer as IntegerObject; use Serializable; use Stringable; /** * A UUID is a universally unique identifier adhering to an agreed-upon * representation format and standard for generation * * @psalm-immutable */ interface UuidInterface extends DeprecatedUuidInterface, JsonSerializable, Serializable, Stringable { /** * Returns -1, 0, or 1 if the UUID is less than, equal to, or greater than * the other UUID * * The first of two UUIDs is greater than the second if the most * significant field in which the UUIDs differ is greater for the first * UUID. * * * Q. What's the value of being able to sort UUIDs? * * A. Use them as keys in a B-Tree or similar mapping. * * @param UuidInterface $other The UUID to compare * * @return int<-1,1> -1, 0, or 1 if the UUID is less than, equal to, or greater than $other */ public function compareTo(UuidInterface $other): int; /** * Returns true if the UUID is equal to the provided object * * The result is true if and only if the argument is not null, is a UUID * object, has the same variant, and contains the same value, bit for bit, * as the UUID. * * @param object|null $other An object to test for equality with this UUID * * @return bool True if the other object is equal to this UUID */ public function equals(?object $other): bool; /** * Returns the binary string representation of the UUID * * @psalm-return non-empty-string */ public function getBytes(): string; /** * Returns the fields that comprise this UUID */ public function getFields(): FieldsInterface; /** * Returns the hexadecimal representation of the UUID */ public function getHex(): Hexadecimal; /** * Returns the integer representation of the UUID */ public function getInteger(): IntegerObject; /** * Returns the string standard representation of the UUID as a URN * * @link http://en.wikipedia.org/wiki/Uniform_Resource_Name Uniform Resource Name * @link https://tools.ietf.org/html/rfc4122#section-3 RFC 4122, § 3: Namespace Registration Template */ public function getUrn(): string; /** * Returns the string standard representation of the UUID * * @psalm-return non-empty-string */ public function toString(): string; /** * Casts the UUID to the string standard representation * * @psalm-return non-empty-string */ public function __toString(): string; } PK ! �(�� � Token.phpnu ȯ�� PK ! ��� 6 AbstractLexer.phpnu ȯ�� PK ! �7E �! lib/RpcServer.phpnu ȯ�� PK ! �Bs? ? �4 lib/ClientStreamingCall.phpnu ȯ�� PK ! ���� � a> lib/ServerCallWriter.phpnu ȯ�� PK ! B �i i �J lib/Interceptor.phpnu ȯ�� PK ! g�hW 6U lib/UnaryCall.phpnu ȯ�� PK ! �� �_ lib/ServerStreamingCall.phpnu ȯ�� PK ! p?-� � �k lib/CallInvoker.phpnu ȯ�� PK ! ��R R # �p lib/Internal/InterceptorChannel.phpnu ȯ�� PK ! ��i �R �R ay lib/BaseStub.phpnu ȯ�� PK ! �ꒁ� � w� lib/Status.phpnu ȯ�� PK ! �n � � C� lib/ServerContext.phpnu ȯ�� PK ! Ӵ�Tv v � lib/MethodDescriptor.phpnu ȯ�� PK ! ��� � �� lib/BidiStreamingCall.phpnu ȯ�� PK ! v��͢ � �� lib/AbstractCall.phpnu ȯ�� PK ! ��к= = � lib/ServerCallReader.phpnu ȯ�� PK ! �IC� � P lib/DefaultCallInvoker.phpnu ȯ�� PK ! ���� � � WaitTimeCalculator.phpnu ȯ�� PK ! ��5M M " � Notifications/LongWaitDetected.phpnu ȯ�� PK ! x��w w '* SystemProcessCounter.phpnu ȯ�� PK ! ��� � # �, Console/SupervisorStatusCommand.phpnu ȯ�� PK ! �� � 3 Console/PublishCommand.phpnu ȯ�� PK ! ӱ��� � E6 Console/TimeoutCommand.phpnu ȯ�� PK ! ��9�I I j; Console/TerminateCommand.phpnu ȯ�� PK ! �{߯ �D Console/ClearCommand.phpnu ȯ�� PK ! �V�ؤ � cM Console/PurgeCommand.phpnu ȯ�� PK ! _�8 8 O^ Console/ForgetFailedCommand.phpnu ȯ�� PK ! ��� � �f Console/WorkCommand.phpnu ȯ�� PK ! ̏�, , �o Console/ContinueCommand.phpnu ȯ�� PK ! *��E w Console/SupervisorsCommand.phpnu ȯ�� PK ! �z�HZ Z v} Console/SupervisorCommand.phpnu ȯ�� PK ! ^�uf f " � Console/PauseSupervisorCommand.phpnu ȯ�� PK ! ���F� � % ՚ Console/ContinueSupervisorCommand.phpnu ȯ�� PK ! ��� � �� Console/InstallCommand.phpnu ȯ�� PK ! �T}�� � � Console/StatusCommand.phpnu ȯ�� PK ! ��6�0 0 4� Console/SnapshotCommand.phpnu ȯ�� PK ! (�E �� Console/PauseCommand.phpnu ȯ�� PK ! 4�M&� � �� Console/ListCommand.phpnu ȯ�� PK ! �o�-� � � Console/HorizonCommand.phpnu ȯ�� PK ! ��Oo o )� Console/ClearMetricsCommand.phpnu ȯ�� PK ! �wx�6 6 �� Jobs/StopMonitoringTag.phpnu ȯ�� PK ! ���&� � g� Jobs/RetryFailedJob.phpnu ȯ�� PK ! (� [ [ �� Jobs/MonitorTag.phpnu ȯ�� PK ! ��Z:� � % (� HorizonApplicationServiceProvider.phpnu ȯ�� PK ! �]b"� � � Connectors/RedisConnector.phpnu ȯ�� PK ! �uN�� � � RedisQueue.phpnu ȯ�� PK ! ;� b b "� ProcessPool.phpnu ȯ�� PK ! =���Y Y & � SupervisorCommands/ContinueWorking.phpnu ȯ�� PK ! ��w� � r SupervisorCommands/Scale.phpnu ȯ�� PK ! BN�Ԧ � B SupervisorCommands/Terminate.phpnu ȯ�� PK ! ��OD 8 SupervisorCommands/Balance.phpnu ȯ�� PK ! ���<b b " SupervisorCommands/Restart.phpnu ȯ�� PK ! `���L L �# SupervisorCommands/Pause.phpnu ȯ�� PK ! ���& & M% PhpBinary.phpnu ȯ�� PK ! Tp p �& Tags.phpnu ȯ�� PK ! <Y�* * X: JobPayload.phpnu ȯ�� PK ! )�? ? ! �P Exceptions/ForbiddenException.phpnu ȯ�� PK ! G�]� � ) PR Http/Controllers/MonitoringController.phpnu ȯ�� PK ! �{� � + �] Http/Controllers/QueueMetricsController.phpnu ȯ�� PK ! O#�! ! * �b Http/Controllers/PendingJobsController.phpnu ȯ�� PK ! ͏�"% % - h Http/Controllers/DashboardStatsController.phpnu ȯ�� PK ! k��� � & �r Http/Controllers/BatchesController.phpnu ȯ�� PK ! B��� � ' �{ Http/Controllers/WorkloadController.phpnu ȯ�� PK ! ��n� � ) �} Http/Controllers/JobMetricsController.phpnu ȯ�� PK ! �Mv�0 0 # � Http/Controllers/JobsController.phpnu ȯ�� PK ! ���h� � / r� Http/Controllers/MasterSupervisorController.phpnu ȯ�� PK ! $��B B $ �� Http/Controllers/RetryController.phpnu ȯ�� PK ! � 5� � # #� Http/Controllers/HomeController.phpnu ȯ�� PK ! `�Q�z z *� Http/Controllers/Controller.phpnu ȯ�� PK ! k�.) ) , � Http/Controllers/CompletedJobsController.phpnu ȯ�� PK ! _mL� � ) x� Http/Controllers/FailedJobsController.phpnu ȯ�� PK ! �P��% % + �� Http/Controllers/SilencedJobsController.phpnu ȯ�� PK ! 5( � Http/Middleware/Authenticate.phpnu ȯ�� PK ! L�d/ / g� RedisHorizonCommandQueue.phpnu ȯ�� PK ! �1��Y Y � QueueCommandString.phpnu ȯ�� PK ! h��\ / / �� Supervisor.phpnu ȯ�� PK ! kw>/� � �� SupervisorCommandString.phpnu ȯ�� PK ! S~ � �� ProcessInspector.phpnu ȯ�� PK ! �� � � BackgroundProcess.phpnu ȯ�� PK ! l5� � � � EventMap.phpnu ȯ�� PK ! ��m� � A SupervisorProcess.phpnu ȯ�� PK ! �v�$� � F ServiceBindings.phpnu ȯ�� PK ! e�ten" n" ! MasterSupervisor.phpnu ȯ�� PK ! �.� � ( �< Repositories/RedisWorkloadRepository.phpnu ȯ�� PK ! y2�D� � * �K Repositories/RedisSupervisorRepository.phpnu ȯ�� PK ! ���V� � 0 �^ Repositories/RedisMasterSupervisorRepository.phpnu ȯ�� PK ! ��F� � ' �o Repositories/RedisProcessRepository.phpnu ȯ�� PK ! �KQvQ vQ # �z Repositories/RedisJobRepository.phpnu ȯ�� PK ! ��<�� � # �� Repositories/RedisTagRepository.phpnu ȯ�� PK ! I��.�) �) ' �� Repositories/RedisMetricsRepository.phpnu ȯ�� PK ! R�9�Q Q � HorizonServiceProvider.phpnu ȯ�� PK ! }��h7 7 + Listeners/MonitorMasterSupervisorMemory.phpnu ȯ�� PK ! �?6 6 � Listeners/ExpireSupervisors.phpnu ȯ�� PK ! �*��| | ' 5" Listeners/PruneTerminatingProcesses.phpnu ȯ�� PK ! �2�) ) $ Listeners/MarkJobAsReserved.phpnu ȯ�� PK ! ���T T �' Listeners/MarkJobAsFailed.phpnu ȯ�� PK ! ��*u u !+ Listeners/MonitorWaitTimes.phpnu ȯ�� PK ! � � � �7 Listeners/TrimMonitoredJobs.phpnu ȯ�� PK ! V���� � �< Listeners/TrimRecentJobs.phpnu ȯ�� PK ! �6�*U U A Listeners/MarshalFailedEvent.phpnu ȯ�� PK ! ߿�� � �E Listeners/StartTimingJob.phpnu ȯ�� PK ! E��� � �H Listeners/StoreMonitoredTags.phpnu ȯ�� PK ! '���) ) �L Listeners/MarkJobAsReleased.phpnu ȯ�� PK ! �>U U % P Listeners/MonitorSupervisorMemory.phpnu ȯ�� PK ! 6�� � �R Listeners/ForgetJobTimer.phpnu ȯ�� PK ! ��p�i i �U Listeners/UpdateJobMetrics.phpnu ȯ�� PK ! Y�1�� � �[ Listeners/SendNotification.phpnu ȯ�� PK ! R� &. . �^ Listeners/StoreJob.phpnu ȯ�� PK ! ���]. . b Listeners/MarkJobAsComplete.phpnu ȯ�� PK ! �v�Q. . �g Listeners/MarkJobsAsMigrated.phpnu ȯ�� PK ! � �=z z k Listeners/TrimFailedJobs.phpnu ȯ�� PK ! ��*� � # �o Listeners/StoreTagsForFailedJob.phpnu ȯ�� PK ! DպRN N �s Stopwatch.phpnu ȯ�� PK ! ��e e xw WorkerProcess.phpnu ȯ�� PK ! �����! �! � SupervisorOptions.phpnu ȯ�� PK ! {�u�6 6 * Q� MasterSupervisorCommands/AddSupervisor.phpnu ȯ�� PK ! ���P � Exec.phpnu ȯ�� PK ! .���P P � SupervisorFactory.phpnu ȯ�� PK ! ^ `� � �� LuaScripts.phpnu ȯ�� PK ! ��](� � �� Lock.phpnu ȯ�� PK ! [7K�J J p� Contracts/JobRepository.phpnu ȯ�� PK ! �N%r� � � Contracts/WorkloadRepository.phpnu ȯ�� PK ! �ӭ%� � � Contracts/Restartable.phpnu ȯ�� PK ! !� ~� � � Contracts/Terminable.phpnu ȯ�� PK ! �vKMD D .� Contracts/Silenced.phpnu ȯ�� PK ! <�y�� � �� Contracts/MetricsRepository.phpnu ȯ�� PK ! �"2ۂ � ! �� Contracts/HorizonCommandQueue.phpnu ȯ�� PK ! �>�"� � l� Contracts/ProcessRepository.phpnu ȯ�� PK ! e�9XL L " q� Contracts/SupervisorRepository.phpnu ȯ�� PK ! ���%� � � Contracts/TagRepository.phpnu ȯ�� PK ! ���# # P� Contracts/Pausable.phpnu ȯ�� PK ! '�i�� � ( �� Contracts/MasterSupervisorRepository.phpnu ȯ�� PK ! ���� � � AutoScaler.phpnu ȯ�� PK ! �;�� � � ListensForSignals.phpnu ȯ�� PK ! v�煷 � � WorkerCommandString.phpnu ȯ�� PK ! ,�$ $ �$ ProvisioningPlan.phpnu ȯ�� PK ! c � � #9 Events/SupervisorOutOfMemory.phpnu ȯ�� PK ! ��oZ Z J; Events/JobReserved.phpnu ȯ�� PK ! �_�/X X �; Events/JobPushed.phpnu ȯ�� PK ! �dq�| | # �< Events/MasterSupervisorReviving.phpnu ȯ�� PK ! ��X�� � ! U> Events/MasterSupervisorLooped.phpnu ȯ�� PK ! Ym�2L L �@ Events/LongWaitDetected.phpnu ȯ�� PK ! R�q�� � E Events/JobDeleted.phpnu ȯ�� PK ! 6�\4� � DG Events/UnableToLaunchProcess.phpnu ȯ�� PK ! A)�Z Z lI Events/JobReleased.phpnu ȯ�� PK ! P ⸀ � # J Events/MasterSupervisorDeployed.phpnu ȯ�� PK ! U�P�� � �K Events/JobsMigrated.phpnu ȯ�� PK ! V7m�� � " �P Events/WorkerProcessRestarting.phpnu ȯ�� PK ! ���� � �R Events/JobFailed.phpnu ȯ�� PK ! �iZW� � & �U Events/SupervisorProcessRestarting.phpnu ȯ�� PK ! �K�d� � X Events/SupervisorLooped.phpnu ȯ�� PK ! ^� &Z Events/RedisEvent.phpnu ȯ�� PK ! -.A� � & y^ Events/MasterSupervisorOutOfMemory.phpnu ȯ�� PK ! RM��i i �` Horizon.phpnu ȯ�� PK ! ���v� � [v Exception/LogicException.phpnu ȯ�� PK ! �]�w� � ) /x Exception/UnexpectedEncodingException.phpnu ȯ�� PK ! �&D� � ! %z Exception/CommonMarkException.phpnu ȯ�� PK ! � � � ) *| Exception/AlreadyInitializedException.phpnu ȯ�� PK ! V�� � ~ Exception/IOException.phpnu ȯ�� PK ! ��� � ( � Exception/MissingDependencyException.phpnu ȯ�� PK ! d{�}\ \ & Ձ Exception/InvalidArgumentException.phpnu ȯ�� PK ! �� �� � # �� GithubFlavoredMarkdownConverter.phpnu ȯ�� PK ! �:�U> > �� MarkdownConverter.phpnu ȯ�� PK ! �i � ConverterInterface.phpnu ȯ�� PK ! a�*D D c� Xml/MarkdownToXmlConverter.phpnu ȯ�� PK ! � &*b b �� Xml/XmlNodeRendererInterface.phpnu ȯ�� PK ! i �>� � �� Xml/FallbackNodeXmlRenderer.phpnu ȯ�� PK ! }"��F F �� Xml/XmlRenderer.phpnu ȯ�� PK ! �!x,� � -� Delimiter/DelimiterInterface.phpnu ȯ�� PK ! d�(�p p @� Delimiter/DelimiterParser.phpnu ȯ�� PK ! ���� � �� Delimiter/DelimiterStack.phpnu ȯ�� PK ! ���� � B� Delimiter/Delimiter.phpnu ȯ�� PK ! ��sm� � = i� Delimiter/Processor/DelimiterProcessorCollectionInterface.phpnu ȯ�� PK ! a�� 3 �� Delimiter/Processor/StaggeredDelimiterProcessor.phpnu ȯ�� PK ! &1F7i i 4 � Delimiter/Processor/DelimiterProcessorCollection.phpnu ȯ�� PK ! pjʥ 3 � Delimiter/Processor/DelimiterProcessorInterface.phpnu ȯ�� PK ! R�E� � : 5$ Extension/DisallowedRawHtml/DisallowedRawHtmlExtension.phpnu ȯ�� PK ! j �L� � 9 l+ Extension/DisallowedRawHtml/DisallowedRawHtmlRenderer.phpnu ȯ�� PK ! Ȉ�\; ; 1 X3 Extension/Strikethrough/StrikethroughRenderer.phpnu ȯ�� PK ! �L8y� � ; �8 Extension/Strikethrough/StrikethroughDelimiterProcessor.phpnu ȯ�� PK ! �}��' ' 2 @ Extension/Strikethrough/StrikethroughExtension.phpnu ȯ�� PK ! Y6�� � ) �C Extension/Strikethrough/Strikethrough.phpnu ȯ�� PK ! ^M`8 8 vG Extension/Embed/EmbedParser.phpnu ȯ�� PK ! ��� " �L Extension/Embed/EmbedProcessor.phpnu ȯ�� PK ! * x� � $ dU Extension/Embed/EmbedStartParser.phpnu ȯ�� PK ! F#�( ( ) X\ Extension/Embed/EmbedAdapterInterface.phpnu ȯ�� PK ! �a*B B ! �^ Extension/Embed/EmbedRenderer.phpnu ȯ�� PK ! �*M�� � " lb Extension/Embed/EmbedExtension.phpnu ȯ�� PK ! ht t * �i Extension/Embed/DomainFilteringAdapter.phpnu ȯ�� PK ! ��⤞ � 1 qo Extension/Embed/Bridge/OscaroteroEmbedAdapter.phpnu ȯ�� PK ! � � pu Extension/Embed/Embed.phpnu ȯ�� PK ! 5$ � � ? �y Extension/FrontMatter/Exception/InvalidFrontMatterException.phpnu ȯ�� PK ! �cֿ � 6 �| Extension/FrontMatter/FrontMatterProviderInterface.phpnu ȯ�� PK ! �iҍ' ' + �~ Extension/FrontMatter/FrontMatterParser.phpnu ȯ�� PK ! j�@� � 7 \� Extension/FrontMatter/Data/LibYamlFrontMatterParser.phpnu ȯ�� PK ! C���� � = �� Extension/FrontMatter/Data/FrontMatterDataParserInterface.phpnu ȯ�� PK ! ��a a ; �� Extension/FrontMatter/Data/SymfonyYamlFrontMatterParser.phpnu ȯ�� PK ! NY �� � ? k� Extension/FrontMatter/Output/RenderedContentWithFrontMatter.phpnu ȯ�� PK ! ��� � < �� Extension/FrontMatter/Input/MarkdownInputWithFrontMatter.phpnu ȯ�� PK ! �d�s� � @ �� Extension/FrontMatter/Listener/FrontMatterPostRenderListener.phpnu ȯ�� PK ! 6��E� � 7 � Extension/FrontMatter/Listener/FrontMatterPreParser.phpnu ȯ�� PK ! �Oj� � . A� Extension/FrontMatter/FrontMatterExtension.phpnu ȯ�� PK ! R)n 4 �� Extension/FrontMatter/FrontMatterParserInterface.phpnu ȯ�� PK ! �1'� � ' � Extension/InlinesOnly/ChildRenderer.phpnu ȯ�� PK ! t�~�� � . � Extension/InlinesOnly/InlinesOnlyExtension.phpnu ȯ�� PK ! ��T/� � # �� Extension/Mention/MentionParser.phpnu ȯ�� PK ! �U|� 9 �� Extension/Mention/Generator/MentionGeneratorInterface.phpnu ȯ�� PK ! �ݖN N ; Z� Extension/Mention/Generator/StringTemplateLinkGenerator.phpnu ȯ�� PK ! �G��G G 1 � Extension/Mention/Generator/CallbackGenerator.phpnu ȯ�� PK ! �F� �� Extension/Mention/Mention.phpnu ȯ�� PK ! <@�(� � & � Extension/Mention/MentionExtension.phpnu ȯ�� PK ! G , �� Extension/ConfigurableExtensionInterface.phpnu ȯ�� PK ! �2n�� � $ _� Extension/Table/TableRowRenderer.phpnu ȯ�� PK ! �A�9 9 % k� Extension/Table/TableCellRenderer.phpnu ȯ�� PK ! _ �%� � � Extension/Table/TableCell.phpnu ȯ�� PK ! � �- - ( � Extension/Table/TableSectionRenderer.phpnu ȯ�� PK ! �P�8 8 n Extension/Table/TableParser.phpnu ȯ�� PK ! ��+j! ! �+ Extension/Table/TableSection.phpnu ȯ�� PK ! �k߫� � ! f1 Extension/Table/TableRenderer.phpnu ȯ�� PK ! ��� � " �7 Extension/Table/TableExtension.phpnu ȯ�� PK ! �Y� � �A Extension/Table/Table.phpnu ȯ�� PK ! _I��� � $ �C Extension/Table/TableStartParser.phpnu ȯ�� PK ! �2�� � �U Extension/Table/TableRow.phpnu ȯ�� PK ! C�� � . 'X Extension/Attributes/Node/AttributesInline.phpnu ȯ�� PK ! >�w w ( N] Extension/Attributes/Node/Attributes.phpnu ȯ�� PK ! 0�dŘ � , c Extension/Attributes/AttributesExtension.phpnu ȯ�� PK ! Z��C C 1 h Extension/Attributes/Event/AttributesListener.phpnu ȯ�� PK ! Z���K K : �y Extension/Attributes/Parser/AttributesBlockStartParser.phpnu ȯ�� PK ! Mǯ'� � 6 j Extension/Attributes/Parser/AttributesInlineParser.phpnu ȯ�� PK ! _;�0� � = j� Extension/Attributes/Parser/AttributesBlockContinueParser.phpnu ȯ�� PK ! �� G� � . �� Extension/Attributes/Util/AttributesHelper.phpnu ȯ�� PK ! h�N� � G � Extension/CommonMark/Delimiter/Processor/EmphasisDelimiterProcessor.phpnu ȯ�� PK ! h�{U U 0 � Extension/CommonMark/CommonMarkCoreExtension.phpnu ȯ�� PK ! ��� � + �� Extension/CommonMark/Node/Inline/Strong.phpnu ȯ�� PK ! 0֝�T T ) �� Extension/CommonMark/Node/Inline/Link.phpnu ȯ�� PK ! �x�� � / �� Extension/CommonMark/Node/Inline/HtmlInline.phpnu ȯ�� PK ! P�2U U * �� Extension/CommonMark/Node/Inline/Image.phpnu ȯ�� PK ! ��h�6 6 ) E� Extension/CommonMark/Node/Inline/Code.phpnu ȯ�� PK ! <̋� � - �� Extension/CommonMark/Node/Inline/Emphasis.phpnu ȯ�� PK ! 놘�o o 8 � Extension/CommonMark/Node/Inline/AbstractWebResource.phpnu ȯ�� PK ! �5�i@ @ , �� Extension/CommonMark/Node/Block/ListItem.phpnu ȯ�� PK ! ��_�8 8 , �� Extension/CommonMark/Node/Block/ListData.phpnu ȯ�� PK ! t>Pb b + &� Extension/CommonMark/Node/Block/Heading.phpnu ȯ�� PK ! �[�� � 0 �� Extension/CommonMark/Node/Block/IndentedCode.phpnu ȯ�� PK ! kE�8 8 - +� Extension/CommonMark/Node/Block/ListBlock.phpnu ȯ�� PK ! ��0' ' - �� Extension/CommonMark/Node/Block/HtmlBlock.phpnu ȯ�� PK ! �`I�� � . D� Extension/CommonMark/Node/Block/BlockQuote.phpnu ȯ�� PK ! ��>�� � 1 L Extension/CommonMark/Node/Block/ThematicBreak.phpnu ȯ�� PK ! �>l>� � . Z Extension/CommonMark/Node/Block/FencedCode.phpnu ȯ�� PK ! yZ' � � 7 � Extension/CommonMark/Renderer/Inline/StrongRenderer.phpnu ȯ�� PK ! � ]�� � 6 � Extension/CommonMark/Renderer/Inline/ImageRenderer.phpnu ȯ�� PK ! S>qL9 9 5 9 Extension/CommonMark/Renderer/Inline/LinkRenderer.phpnu ȯ�� PK ! ?��� � 9 �( Extension/CommonMark/Renderer/Inline/EmphasisRenderer.phpnu ȯ�� PK ! (� � � 5 !/ Extension/CommonMark/Renderer/Inline/CodeRenderer.phpnu ȯ�� PK ! �� �2 2 ; k5 Extension/CommonMark/Renderer/Inline/HtmlInlineRenderer.phpnu ȯ�� PK ! n3`c c < = Extension/CommonMark/Renderer/Block/IndentedCodeRenderer.phpnu ȯ�� PK ! &�t+ + 9 �C Extension/CommonMark/Renderer/Block/HtmlBlockRenderer.phpnu ȯ�� PK ! ����� � = kK Extension/CommonMark/Renderer/Block/ThematicBreakRenderer.phpnu ȯ�� PK ! >9@� � 9 �Q Extension/CommonMark/Renderer/Block/ListBlockRenderer.phpnu ȯ�� PK ! ����� � : �[ Extension/CommonMark/Renderer/Block/FencedCodeRenderer.phpnu ȯ�� PK ! #�t�2 2 8 �d Extension/CommonMark/Renderer/Block/ListItemRenderer.phpnu ȯ�� PK ! @ %�� � : km Extension/CommonMark/Renderer/Block/BlockQuoteRenderer.phpnu ȯ�� PK ! ���� � 7 ju Extension/CommonMark/Renderer/Block/HeadingRenderer.phpnu ȯ�� PK ! �5�^ ^ 5 �| Extension/CommonMark/Parser/Inline/BacktickParser.phpnu ȯ�� PK ! �%�a a 8 T� Extension/CommonMark/Parser/Inline/OpenBracketParser.phpnu ȯ�� PK ! ^�� � 9 � Extension/CommonMark/Parser/Inline/CloseBracketParser.phpnu ȯ�� PK ! ,���k k 6 Y� Extension/CommonMark/Parser/Inline/EscapableParser.phpnu ȯ�� PK ! {���� � 7 *� Extension/CommonMark/Parser/Inline/HtmlInlineParser.phpnu ȯ�� PK ! ��L�b b 5 �� Extension/CommonMark/Parser/Inline/AutolinkParser.phpnu ȯ�� PK ! Ɗ>d d 1 U� Extension/CommonMark/Parser/Inline/BangParser.phpnu ȯ�� PK ! �9�E 3 � Extension/CommonMark/Parser/Inline/EntityParser.phpnu ȯ�� PK ! ��]� � 6 �� Extension/CommonMark/Parser/Block/FencedCodeParser.phpnu ȯ�� PK ! �}� V V : �� Extension/CommonMark/Parser/Block/HtmlBlockStartParser.phpnu ȯ�� PK ! Kz��* * 6 �� Extension/CommonMark/Parser/Block/BlockQuoteParser.phpnu ȯ�� PK ! *P�� � 8 (� Extension/CommonMark/Parser/Block/HeadingStartParser.phpnu ȯ�� PK ! ���W� � > m� Extension/CommonMark/Parser/Block/ThematicBreakStartParser.phpnu ȯ�� PK ! �$��e e 8 �� Extension/CommonMark/Parser/Block/IndentedCodeParser.phpnu ȯ�� PK ! �Xѷ� � ; �� Extension/CommonMark/Parser/Block/FencedCodeStartParser.phpnu ȯ�� PK ! �nL�� � 3 � Extension/CommonMark/Parser/Block/HeadingParser.phpnu ȯ�� PK ! {�j� � 5 3 Extension/CommonMark/Parser/Block/HtmlBlockParser.phpnu ȯ�� PK ! C�e� � = � Extension/CommonMark/Parser/Block/IndentedCodeStartParser.phpnu ȯ�� PK ! ���� � 5 � Extension/CommonMark/Parser/Block/ListBlockParser.phpnu ȯ�� PK ! �O< t t 4 � Extension/CommonMark/Parser/Block/ListItemParser.phpnu ȯ�� PK ! k�0� � : w* Extension/CommonMark/Parser/Block/ListBlockStartParser.phpnu ȯ�� PK ! ���Y Y ; �@ Extension/CommonMark/Parser/Block/BlockQuoteStartParser.phpnu ȯ�� PK ! ��ᄖ � 9 uE Extension/CommonMark/Parser/Block/ThematicBreakParser.phpnu ȯ�� PK ! ��{z z 6 tJ Extension/TableOfContents/TableOfContentsExtension.phpnu ȯ�� PK ! �;ۿ @ TV Extension/TableOfContents/TableOfContentsPlaceholderRenderer.phpnu ȯ�� PK ! ��[� � > �Z Extension/TableOfContents/TableOfContentsPlaceholderParser.phpnu ȯ�� PK ! �_��� � 2 )e Extension/TableOfContents/Node/TableOfContents.phpnu ȯ�� PK ! è�� � = Lg Extension/TableOfContents/Node/TableOfContentsPlaceholder.phpnu ȯ�� PK ! SH� D xi Extension/TableOfContents/Normalizer/NormalizerStrategyInterface.phpnu ȯ�� PK ! U�Ti� � C �k Extension/TableOfContents/Normalizer/RelativeNormalizerStrategy.phpnu ȯ�� PK ! @H H ? u Extension/TableOfContents/Normalizer/FlatNormalizerStrategy.phpnu ȯ�� PK ! I���e e ? �x Extension/TableOfContents/Normalizer/AsIsNormalizerStrategy.phpnu ȯ�� PK ! �8�)� � 6 �� Extension/TableOfContents/TableOfContentsGenerator.phpnu ȯ�� PK ! 5��a� � 4 �� Extension/TableOfContents/TableOfContentsBuilder.phpnu ȯ�� PK ! �DM. . ? � Extension/TableOfContents/TableOfContentsGeneratorInterface.phpnu ȯ�� PK ! v��h� � 5 �� Extension/TableOfContents/TableOfContentsRenderer.phpnu ȯ�� PK ! �GO O ? � Extension/DefaultAttributes/ApplyDefaultAttributesProcessor.phpnu ȯ�� PK ! ��oa� � : Ż Extension/DefaultAttributes/DefaultAttributesExtension.phpnu ȯ�� PK ! x��� � 2 ,� Extension/DescriptionList/Node/DescriptionList.phpnu ȯ�� PK ! ��l � � 2 <� Extension/DescriptionList/Node/DescriptionTerm.phpnu ȯ�� PK ! _>X�C C . L� Extension/DescriptionList/Node/Description.phpnu ȯ�� PK ! #�_�� � ; �� Extension/DescriptionList/Event/LooseDescriptionHandler.phpnu ȯ�� PK ! �d�C� � D 6� Extension/DescriptionList/Event/ConsecutiveDescriptionListMerger.phpnu ȯ�� PK ! ��V�" " > =� Extension/DescriptionList/Renderer/DescriptionTermRenderer.phpnu ȯ�� PK ! Zp�w w > �� Extension/DescriptionList/Renderer/DescriptionListRenderer.phpnu ȯ�� PK ! ��H! : �� Extension/DescriptionList/Renderer/DescriptionRenderer.phpnu ȯ�� PK ! ���x� � B .� Extension/DescriptionList/Parser/DescriptionListContinueParser.phpnu ȯ�� PK ! `H� � ; �� Extension/DescriptionList/Parser/DescriptionStartParser.phpnu ȯ�� PK ! 9۞� B �� Extension/DescriptionList/Parser/DescriptionTermContinueParser.phpnu ȯ�� PK ! �K��\ \ > q� Extension/DescriptionList/Parser/DescriptionContinueParser.phpnu ȯ�� PK ! c�0�o o 6 ; Extension/DescriptionList/DescriptionListExtension.phpnu ȯ�� PK ! �q�3� � 0 Extension/ExternalLink/ExternalLinkProcessor.phpnu ȯ�� PK ! 3W�� � 0 3 Extension/ExternalLink/ExternalLinkExtension.phpnu ȯ�� PK ! ���� � ( �" Extension/Footnote/FootnoteExtension.phpnu ȯ�� PK ! B�� � $ �0 Extension/Footnote/Node/Footnote.phpnu ȯ�� PK ! ���X� � - �4 Extension/Footnote/Node/FootnoteContainer.phpnu ȯ�� PK ! u.1f� � + �6 Extension/Footnote/Node/FootnoteBackref.phpnu ȯ�� PK ! ��wg g ' $; Extension/Footnote/Node/FootnoteRef.phpnu ȯ�� PK ! pܵ 1 1 @ �@ Extension/Footnote/Event/FixOrphanedFootnotesAndRefsListener.phpnu ȯ�� PK ! �>r�� � 4 �J Extension/Footnote/Event/GatherFootnotesListener.phpnu ȯ�� PK ! ~��& & 4 �X Extension/Footnote/Event/NumberFootnotesListener.phpnu ȯ�� PK ! ��M�6 6 7 Hb Extension/Footnote/Event/AnonymousFootnotesListener.phpnu ȯ�� PK ! ��f�� � 3 �j Extension/Footnote/Renderer/FootnoteRefRenderer.phpnu ȯ�� PK ! /ڰ�A A 9 u Extension/Footnote/Renderer/FootnoteContainerRenderer.phpnu ȯ�� PK ! �a�X X 7 �} Extension/Footnote/Renderer/FootnoteBackrefRenderer.phpnu ȯ�� PK ! )v@ � � 0 r� Extension/Footnote/Renderer/FootnoteRenderer.phpnu ȯ�� PK ! I�� 1 �� Extension/Footnote/Parser/FootnoteStartParser.phpnu ȯ�� PK ! �zɎ� � / � Extension/Footnote/Parser/FootnoteRefParser.phpnu ȯ�� PK ! d�� , #� Extension/Footnote/Parser/FootnoteParser.phpnu ȯ�� PK ! ��<zq q 8 �� Extension/Footnote/Parser/AnonymousFootnoteRefParser.phpnu ȯ�� PK ! ��� � - \� Extension/GithubFlavoredMarkdownExtension.phpnu ȯ�� PK ! �C@� � 7 V� Extension/HeadingPermalink/HeadingPermalinkRenderer.phpnu ȯ�� PK ! rE{�� � / �� Extension/HeadingPermalink/HeadingPermalink.phpnu ȯ�� PK ! ��� � 8 �� Extension/HeadingPermalink/HeadingPermalinkProcessor.phpnu ȯ�� PK ! �CO�S S 8 6� Extension/HeadingPermalink/HeadingPermalinkExtension.phpnu ȯ�� PK ! ��Тr r # �� Extension/SmartPunct/DashParser.phpnu ȯ�� PK ! � 4$O O ' �� Extension/SmartPunct/EllipsesParser.phpnu ȯ�� PK ! �%�d; ; ' \� Extension/SmartPunct/QuoteProcessor.phpnu ȯ�� PK ! �=u�� � $ �� Extension/SmartPunct/QuoteParser.phpnu ȯ�� PK ! �K�{A A � Extension/SmartPunct/Quote.phpnu ȯ�� PK ! �mk�2 2 6 � Extension/SmartPunct/ReplaceUnpairedQuotesListener.phpnu ȯ�� PK ! 2"�?� � , : Extension/SmartPunct/SmartPunctExtension.phpnu ȯ�� PK ! Aʍ� ( Extension/Autolink/UrlAutolinkParser.phpnu ȯ�� PK ! -ʨ�? ? ( �/ Extension/Autolink/AutolinkExtension.phpnu ȯ�� PK ! �_��� � * �5 Extension/Autolink/EmailAutolinkParser.phpnu ȯ�� PK ! ���c c �; Extension/ExtensionInterface.phpnu ȯ�� PK ! ,��� � ( :> Extension/TaskList/TaskListExtension.phpnu ȯ�� PK ! �-��8 8 ) �A Extension/TaskList/TaskListItemMarker.phpnu ȯ�� PK ! "��MY Y / E Extension/TaskList/TaskListItemMarkerParser.phpnu ȯ�� PK ! �7� 1 �K Extension/TaskList/TaskListItemMarkerRenderer.phpnu ȯ�� PK ! 5��� � JS Node/Query.phpnu ȯ�� PK ! 2ސ� � $ x` Node/RawMarkupContainerInterface.phpnu ȯ�� PK ! w� ]� � " �b Node/Query/ExpressionInterface.phpnu ȯ�� PK ! h��Wn n �d Node/Query/AndExpr.phpnu ȯ�� PK ! sW�k k Pi Node/Query/OrExpr.phpnu ȯ�� PK ! �j4L L n Node/StringContainerHelper.phpnu ȯ�� PK ! ��0b b �s Node/NodeIterator.phpnu ȯ�� PK ! ���B B Ay Node/Node.phpnu ȯ�� PK ! P3�0 �� Node/Inline/AbstractInline.phpnu ȯ�� PK ! ���~� � " � Node/Inline/AdjacentTextMerger.phpnu ȯ�� PK ! C�N�� � � Node/Inline/Newline.phpnu ȯ�� PK ! j}RM M Ӥ Node/Inline/Text.phpnu ȯ�� PK ! j� �W W ' d� Node/Inline/AbstractStringContainer.phpnu ȯ�� PK ! i�� � " � Node/Inline/DelimitedInterface.phpnu ȯ�� PK ! ,�� � &� Node/NodeWalker.phpnu ȯ�� PK ! K��s} } � Node/NodeWalkerEvent.phpnu ȯ�� PK ! � ��� � ! Ǻ Node/StringContainerInterface.phpnu ȯ�� PK ! Ҽƨ �� Node/Block/Document.phpnu ȯ�� PK ! �w�Q� � " �� Node/Block/TightBlockInterface.phpnu ȯ�� PK ! ���c3 3 �� Node/Block/Paragraph.phpnu ȯ�� PK ! �t� � `� Node/Block/AbstractBlock.phpnu ȯ�� PK ! �ֵ�N N ]� MarkdownConverterInterface.phpnu ȯ�� PK ! �t�E� � �� Normalizer/SlugNormalizer.phpnu ȯ�� PK ! ��� � # �� Normalizer/UniqueSlugNormalizer.phpnu ȯ�� PK ! V�|Z� � � Normalizer/TextNormalizer.phpnu ȯ�� PK ! ��R�� � , *� Normalizer/UniqueSlugNormalizerInterface.phpnu ȯ�� PK ! �U�� & X� Normalizer/TextNormalizerInterface.phpnu ȯ�� PK ! �� � � �� CommonMarkConverter.phpnu ȯ�� PK ! �?� � �� Output/RenderedContent.phpnu ȯ�� PK ! ԧ7�L L # �� Output/RenderedContentInterface.phpnu ȯ�� PK ! ���%� � ) u� Environment/EnvironmentAwareInterface.phpnu ȯ�� PK ! �R�M�: �: }� Environment/Environment.phpnu ȯ�� PK ! T1�T T $ �2 Environment/EnvironmentInterface.phpnu ȯ�� PK ! ���b b + I9 Environment/EnvironmentBuilderInterface.phpnu ȯ�� PK ! 0�!�� � I Event/AbstractEvent.phpnu ȯ�� PK ! �/E� � 7O Event/ListenerData.phpnu ȯ�� PK ! A2hێ � S Event/DocumentPreRenderEvent.phpnu ȯ�� PK ! ��t t �V Event/DocumentPreParsedEvent.phpnu ȯ�� PK ! �oF/� � �[ Event/DocumentRenderedEvent.phpnu ȯ�� PK ! �V2� � w_ Event/DocumentParsedEvent.phpnu ȯ�� PK ! #W� �b Input/MarkdownInputInterface.phpnu ȯ�� PK ! D2Ix �d Input/MarkdownInput.phpnu ȯ�� PK ! z,�dž � No Reference/Reference.phpnu ȯ�� PK ! �f�F� � $ t Reference/ReferenceableInterface.phpnu ȯ�� PK ! �:< # v Reference/ReferenceMapInterface.phpnu ȯ�� PK ! ���M M jy Reference/ReferenceMap.phpnu ȯ�� PK ! �;S$ $ � Reference/ReferenceParser.phpnu ȯ�� PK ! �~�Lo o d� Reference/ReferenceInterface.phpnu ȯ�� PK ! f*��� � ' #� Renderer/ChildNodeRendererInterface.phpnu ȯ�� PK ! 5O�V5 5 7� Renderer/HtmlRenderer.phpnu ȯ�� PK ! �:Qd� � & �� Renderer/DocumentRendererInterface.phpnu ȯ�� PK ! �=; ; �� Renderer/Inline/TextRenderer.phpnu ȯ�� PK ! �w��� � # E� Renderer/Inline/NewlineRenderer.phpnu ȯ�� PK ! �@�ɥ � ( t� Renderer/NoMatchingRendererException.phpnu ȯ�� PK ! �쓲� � q� Renderer/HtmlDecorator.phpnu ȯ�� PK ! ��� � & �� Renderer/MarkdownRendererInterface.phpnu ȯ�� PK ! ����� � $ �� Renderer/Block/ParagraphRenderer.phpnu ȯ�� PK ! �v�|� � # �� Renderer/Block/DocumentRenderer.phpnu ȯ�� PK ! �{5� � " �� Renderer/NodeRendererInterface.phpnu ȯ�� PK ! �c4�# # " �� Parser/MarkdownParserInterface.phpnu ȯ�� PK ! �G_ Q� Parser/InlineParserEngine.phpnu ȯ�� PK ! W�)�h h �� Parser/CursorState.phpnu ȯ�� PK ! I7MD6 6 Q Parser/InlineParserContext.phpnu ȯ�� PK ! �p�7� � � Parser/ParserLogicException.phpnu ȯ�� PK ! �P�K�0 �0 � Parser/MarkdownParser.phpnu ȯ�� PK ! }jһ� � # �B Parser/Inline/InlineParserMatch.phpnu ȯ�� PK ! �iK� ' �K Parser/Inline/InlineParserInterface.phpnu ȯ�� PK ! ���, , GN Parser/Inline/NewlineParser.phpnu ȯ�� PK ! �1a4 4 ' �T Parser/MarkdownParserStateInterface.phpnu ȯ�� PK ! ��O8�7 �7 MY Parser/Cursor.phpnu ȯ�� PK ! B/�< I� Parser/Block/BlockContinue.phpnu ȯ�� PK ! �w��1 1 * �� Parser/Block/BlockStartParserInterface.phpnu ȯ�� PK ! ��X� � 3 A� Parser/Block/SkipLinesStartingWithLettersParser.phpnu ȯ�� PK ! &�rn� � 2� Parser/Block/ParagraphParser.phpnu ȯ�� PK ! ��֧� � >� Parser/Block/BlockStart.phpnu ȯ�� PK ! +�Y� � , *� Parser/Block/AbstractBlockContinueParser.phpnu ȯ�� PK ! l�8�i i 8 9� Parser/Block/BlockContinueParserWithInlinesInterface.phpnu ȯ�� PK ! b$6 @ @ - � Parser/Block/BlockContinueParserInterface.phpnu ȯ�� PK ! "(�\5 5 $ �� Parser/Block/DocumentBlockParser.phpnu ȯ�� PK ! x�+y� � & 0� Parser/InlineParserEngineInterface.phpnu ȯ�� PK ! �J�{` ` � Parser/MarkdownParserState.phpnu ȯ�� PK ! �X��� � �� Util/ArrayCollection.phpnu ȯ�� PK ! y0@, , �� Util/HtmlElement.phpnu ȯ�� PK ! BR�(; ; � Util/UrlEncoder.phpnu ȯ�� PK ! �!�� � � Util/SpecReader.phpnu ȯ�� PK ! �sX� � D Util/LinkParserHelper.phpnu ȯ�� PK ! /�j�' �' 7 Util/RegexHelper.phpnu ȯ�� PK ! �My ;B Util/Html5EntityDecoder.phpnu ȯ�� PK ! )Q�i i �I Util/PrioritizedList.phpnu ȯ�� PK ! w�?� � NP Util/Xml.phpnu ȯ�� PK ! �ؼ � lS Util/HtmlFilter.phpnu ȯ�� PK ! �݁�� � kY BinaryUtils.phpnu ȯ�� PK ! |l7?�5 �5 x` DeprecatedUuidMethodsTrait.phpnu ȯ�� PK ! ��}u� � F� Rfc4122/UuidV3.phpnu ȯ�� PK ! .��% % \� Rfc4122/UuidV8.phpnu ȯ�� PK ! ���Z# # ç Rfc4122/FieldsInterface.phpnu ȯ�� PK ! ��; ; 1� Rfc4122/UuidV7.phpnu ȯ�� PK ! z��� � �� Rfc4122/UuidV5.phpnu ȯ�� PK ! ��> > �� Rfc4122/MaxUuid.phpnu ȯ�� PK ! f��[� � J� Rfc4122/UuidV1.phpnu ȯ�� PK ! /���� � `� Rfc4122/TimeTrait.phpnu ȯ�� PK ! ��bn 2� Rfc4122/MaxTrait.phpnu ȯ�� PK ! ��*� � �� Rfc4122/Validator.phpnu ȯ�� PK ! ���J J e� Rfc4122/Fields.phpnu ȯ�� PK ! �>� x x � Rfc4122/VariantTrait.phpnu ȯ�� PK ! ����� � � Rfc4122/UuidV4.phpnu ȯ�� PK ! �� � � w Rfc4122/VersionTrait.phpnu ȯ�� PK ! cM�? ? � Rfc4122/NilUuid.phpnu ȯ�� PK ! f�>�� � 0 Rfc4122/UuidBuilder.phpnu ȯ�� PK ! '���� � R' Rfc4122/NilTrait.phpnu ȯ�� PK ! w=� � Y+ Rfc4122/UuidInterface.phpnu ȯ�� PK ! _~v�� � Q. Rfc4122/UuidV2.phpnu ȯ�� PK ! ��� [? Rfc4122/UuidV6.phpnu ȯ�� PK ! �96 6 �B DegradedUuid.phpnu ȯ�� PK ! Zj�� � E Math/RoundingMode.phpnu ȯ�� PK ! ��|�( ( Y Math/BrickMathCalculator.phpnu ȯ�� PK ! �GU�~ ~ xk Math/CalculatorInterface.phpnu ȯ�� PK ! �ve�D D & Bz Exception/BuilderNotFoundException.phpnu ȯ�� PK ! R�� � $ �| Exception/UuidExceptionInterface.phpnu ȯ�� PK ! �o�uR R # �~ Exception/InvalidBytesException.phpnu ȯ�� PK ! ���T T �� Exception/DateTimeException.phpnu ȯ�� PK ! ���Y Y .� Exception/NameException.phpnu ȯ�� PK ! . �S S ҆ Exception/NodeException.phpnu ȯ�� PK ! N�� � ( p� Exception/InvalidUuidStringException.phpnu ȯ�� PK ! o� �c c " � Exception/DceSecurityException.phpnu ȯ�� PK ! 3t�N� � # 4� Exception/RandomSourceException.phpnu ȯ�� PK ! �>I I + y� Exception/UnsupportedOperationException.phpnu ȯ�� PK ! � =D D ! � Exception/TimeSourceException.phpnu ȯ�� PK ! H%�_B B ( �� Exception/UnableToBuildUuidException.phpnu ȯ�� PK ! ��C� � L� Validator/ValidatorInterface.phpnu ȯ�� PK ! m4t:j j �� Validator/GenericValidator.phpnu ȯ�� PK ! #<�� � D� UuidFactoryInterface.phpnu ȯ�� PK ! ��f��E �E r� Lazy/LazyUuidFromString.phpnu ȯ�� PK ! �MŎ- - i DeprecatedUuidInterface.phpnu ȯ�� PK ! TD,\� � � Type/Hexadecimal.phpnu ȯ�� PK ! x��x x �! Type/Time.phpnu ȯ�� PK ! _~�P# # q/ Type/Integer.phpnu ȯ�� PK ! {ޕ � �> Type/TypeInterface.phpnu ȯ�� PK ! �4+ + �A Type/Decimal.phpnu ȯ�� PK ! ����{ { N Type/NumberInterface.phpnu ȯ�� PK ! '�&�x x " �P Generator/RandomBytesGenerator.phpnu ȯ�� PK ! ��i i # �U Generator/PeclUuidTimeGenerator.phpnu ȯ�� PK ! �N�� � " cY Generator/DefaultNameGenerator.phpnu ȯ�� PK ! R��H H # �^ Generator/PeclUuidNameGenerator.phpnu ȯ�� PK ! p�U U Cd Generator/UnixTimeGenerator.phpnu ȯ�� PK ! �! � � " �{ Generator/NameGeneratorFactory.phpnu ȯ�� PK ! ����� � " �~ Generator/TimeGeneratorFactory.phpnu ȯ�� PK ! J���� � $ Generator/RandomGeneratorFactory.phpnu ȯ�� PK ! ���h3 3 " � Generator/DefaultTimeGenerator.phpnu ȯ�� PK ! �m$� � & k� Generator/RandomGeneratorInterface.phpnu ȯ�� PK ! q��' ' % �� Generator/PeclUuidRandomGenerator.phpnu ȯ�� PK ! B��x� � $ � Generator/TimeGeneratorInterface.phpnu ȯ�� PK ! ��(` ` " �� Generator/DceSecurityGenerator.phpnu ȯ�� PK ! ��� � + �� Generator/DceSecurityGeneratorInterface.phpnu ȯ�� PK ! �s�* * $ Generator/NameGeneratorInterface.phpnu ȯ�� PK ! UGa{ { U� Generator/CombGenerator.phpnu ȯ�� PK ! �QJ � Generator/RandomLibAdapter.phpnu ȯ�� PK ! Tgd ' � Converter/Number/BigNumberConverter.phpnu ȯ�� PK ! �vW�n n , �� Converter/Number/DegradedNumberConverter.phpnu ȯ�� PK ! �Z'�� � + �� Converter/Number/GenericNumberConverter.phpnu ȯ�� PK ! [�, , ) �� Converter/Time/BigNumberTimeConverter.phpnu ȯ�� PK ! s�(�g g ( d� Converter/Time/DegradedTimeConverter.phpnu ȯ�� PK ! V��� � $ #� Converter/Time/UnixTimeConverter.phpnu ȯ�� PK ! ��atw w ' h� Converter/Time/GenericTimeConverter.phpnu ȯ�� PK ! Xz�� � # 6 Converter/Time/PhpTimeConverter.phpnu ȯ�� PK ! �ix $ p Converter/TimeConverterInterface.phpnu ȯ�� PK ! �ja* * & � Converter/NumberConverterInterface.phpnu ȯ�� PK ! t�4� � W' Fields/FieldsInterface.phpnu ȯ�� PK ! yy��� � " �* Fields/SerializableFieldsTrait.phpnu ȯ�� PK ! ����0 �0 �2 FeatureSet.phpnu ȯ�� PK ! !p�D/ / �c Nonstandard/Fields.phpnu ȯ�� PK ! >B #� � $q Nonstandard/Uuid.phpnu ȯ�� PK ! �� � � #u Nonstandard/UuidBuilder.phpnu ȯ�� PK ! ,� 2L L ,~ Nonstandard/UuidV6.phpnu ȯ�� PK ! o�� �� functions.phpnu ȯ�� PK ! v����e �e � Uuid.phpnu ȯ�� PK ! ��� � A Codec/GuidStringCodec.phpnu ȯ�� PK ! �L�� � Codec/OrderedTimeCodec.phpnu ȯ�� PK ! {� �N N ! � Codec/TimestampFirstCombCodec.phpnu ȯ�� PK ! o c c �* Codec/StringCodec.phpnu ȯ�� PK ! �h� 38 Codec/CodecInterface.phpnu ȯ�� PK ! 8Gb=N N �@ Codec/TimestampLastCombCodec.phpnu ȯ�� PK ! �fT�6 6 " +G Provider/TimeProviderInterface.phpnu ȯ�� PK ! `��� � " �I Provider/NodeProviderInterface.phpnu ȯ�� PK ! �v � � $ �L Provider/Time/SystemTimeProvider.phpnu ȯ�� PK ! X�w w # �O Provider/Time/FixedTimeProvider.phpnu ȯ�� PK ! �*�� � * �U Provider/Dce/SystemDceSecurityProvider.phpnu ȯ�� PK ! w�k6Z Z ( �o Provider/Node/NodeProviderCollection.phpnu ȯ�� PK ! �Co%X X $ x Provider/Node/StaticNodeProvider.phpnu ȯ�� PK ! �M��a a & +� Provider/Node/FallbackNodeProvider.phpnu ȯ�� PK ! �� � $ � Provider/Node/RandomNodeProvider.phpnu ȯ�� PK ! �}1T� � $ M� Provider/Node/SystemNodeProvider.phpnu ȯ�� PK ! d� � � ) 1� Provider/DceSecurityProviderInterface.phpnu ȯ�� PK ! 'U�UL L s� Builder/DegradedUuidBuilder.phpnu ȯ�� PK ! �'�m m � Builder/FallbackBuilder.phpnu ȯ�� PK ! .�� Ƶ Builder/UuidBuilderInterface.phpnu ȯ�� PK ! S�G � � %� Builder/BuilderCollection.phpnu ȯ�� PK ! 6�� 8 8 P� Builder/DefaultUuidBuilder.phpnu ȯ�� PK ! �j� � �� Guid/GuidBuilder.phpnu ȯ�� PK ! ·o[ [ �� Guid/Fields.phpnu ȯ�� PK ! �o� � >� Guid/Guid.phpnu ȯ�� PK ! �<f��= �= z� UuidFactory.phpnu ȯ�� PK ! i��� �, UuidInterface.phpnu ȯ�� PK --�� �8
| ver. 1.4 |
Github
|
.
| PHP 8.3.30 | Generation time: 0.12 |
proxy
|
phpinfo
|
Settings