晋太元中,武陵人捕鱼为业。缘溪行,忘路之远近。忽逢桃花林,夹岸数百步,中无杂树,芳草鲜美,落英缤纷。渔人甚异之,复前行,欲穷其林。 林尽水源,便得一山,山有小口,仿佛若有光。便舍船,从口入。初极狭,才通人。复行数十步,豁然开朗。土地平旷,屋舍俨然,有良田、美池、桑竹之属。阡陌交通,鸡犬相闻。其中往来种作,男女衣着,悉如外人。黄发垂髫,并怡然自乐。 见渔人,乃大惊,问所从来。具答之。便要还家,设酒杀鸡作食。村中闻有此人,咸来问讯。自云先世避秦时乱,率妻子邑人来此绝境,不复出焉,遂与外人间隔。问今是何世,乃不知有汉,无论魏晋。此人一一为具言所闻,皆叹惋。余人各复延至其家,皆出酒食。停数日,辞去。此中人语云:“不足为外人道也。”(间隔 一作:隔绝) 既出,得其船,便扶向路,处处志之。及郡下,诣太守,说如此。太守即遣人随其往,寻向所志,遂迷,不复得路。 南阳刘子骥,高尚士也,闻之,欣然规往。未果,寻病终。后遂无问津者。
|
Server : Apache System : Linux srv.rainic.com 4.18.0-553.47.1.el8_10.x86_64 #1 SMP Wed Apr 2 05:45:37 EDT 2025 x86_64 User : rainic ( 1014) PHP Version : 7.4.33 Disable Function : exec,passthru,shell_exec,system Directory : /opt/cpanel/ea-wappspector/vendor/rector/rector/rules/TypeDeclaration/ |
Upload File : |
<?php
declare (strict_types=1);
namespace Rector\TypeDeclaration;
use PHPStan\Type\ArrayType;
use PHPStan\Type\Constant\ConstantArrayType;
use PHPStan\Type\MixedType;
use PHPStan\Type\NeverType;
use PHPStan\Type\Type;
use PHPStan\Type\TypeTraverser;
use PHPStan\Type\UnionType;
use Rector\TypeDeclaration\ValueObject\NestedArrayType;
use Rector\Util\Reflection\PrivatesAccessor;
/**
* @see \Rector\Tests\TypeDeclaration\TypeNormalizerTest
*/
final class TypeNormalizer
{
/**
* @readonly
* @var \Rector\Util\Reflection\PrivatesAccessor
*/
private $privatesAccessor;
/**
* @var NestedArrayType[]
*/
private $collectedNestedArrayTypes = [];
public function __construct(PrivatesAccessor $privatesAccessor)
{
$this->privatesAccessor = $privatesAccessor;
}
/**
* @api
*
* Turn nested array union types to unique ones:
* e.g. int[]|string[][]|bool[][]|string[][]
* ↓
* int[]|string[][]|bool[][]
*/
public function normalizeArrayOfUnionToUnionArray(Type $type, int $arrayNesting = 1) : Type
{
if (!$type instanceof ArrayType) {
return $type;
}
if ($type instanceof ConstantArrayType && $arrayNesting === 1) {
return $type;
}
// first collection of types
if ($arrayNesting === 1) {
$this->collectedNestedArrayTypes = [];
}
if ($type->getItemType() instanceof ArrayType) {
++$arrayNesting;
$this->normalizeArrayOfUnionToUnionArray($type->getItemType(), $arrayNesting);
} elseif ($type->getItemType() instanceof UnionType) {
$this->collectNestedArrayTypeFromUnionType($type->getItemType(), $arrayNesting);
} else {
$this->collectedNestedArrayTypes[] = new NestedArrayType($type->getItemType(), $arrayNesting, $type->getKeyType());
}
return $this->createUnionedTypesFromArrayTypes($this->collectedNestedArrayTypes);
}
/**
* From "string[]|mixed[]" based on empty array to to "string[]"
*/
public function normalizeArrayTypeAndArrayNever(Type $type) : Type
{
return TypeTraverser::map($type, function (Type $traversedType, callable $traverserCallable) : Type {
if ($this->isConstantArrayNever($traversedType)) {
\assert($traversedType instanceof ConstantArrayType);
// not sure why, but with direct new node everything gets nulled to MixedType
$this->privatesAccessor->setPrivateProperty($traversedType, 'keyType', new MixedType());
$this->privatesAccessor->setPrivateProperty($traversedType, 'itemType', new MixedType());
return $traversedType;
}
if ($traversedType instanceof NeverType) {
return new MixedType();
}
return $traverserCallable($traversedType, $traverserCallable);
});
}
private function isConstantArrayNever(Type $type) : bool
{
return $type instanceof ConstantArrayType && $type->getKeyType() instanceof NeverType && $type->getItemType() instanceof NeverType;
}
private function collectNestedArrayTypeFromUnionType(UnionType $unionType, int $arrayNesting) : void
{
foreach ($unionType->getTypes() as $unionedType) {
if ($unionedType->isArray()->yes()) {
++$arrayNesting;
$this->normalizeArrayOfUnionToUnionArray($unionedType, $arrayNesting);
} else {
$this->collectedNestedArrayTypes[] = new NestedArrayType($unionedType, $arrayNesting);
}
}
}
/**
* @param NestedArrayType[] $collectedNestedArrayTypes
* @return \PHPStan\Type\UnionType|\PHPStan\Type\ArrayType
*/
private function createUnionedTypesFromArrayTypes(array $collectedNestedArrayTypes)
{
$unionedTypes = [];
foreach ($collectedNestedArrayTypes as $collectedNestedArrayType) {
$arrayType = $collectedNestedArrayType->getType();
for ($i = 0; $i < $collectedNestedArrayType->getArrayNestingLevel(); ++$i) {
$arrayType = new ArrayType($collectedNestedArrayType->getKeyType(), $arrayType);
}
/** @var ArrayType $arrayType */
$unionedTypes[] = $arrayType;
}
if (\count($unionedTypes) > 1) {
return new UnionType($unionedTypes);
}
return $unionedTypes[0];
}
}