>UgNwVH+$Syh 0t;@
HO~]\o/ˇi7K/R͵[|[sC.aG& #)`II$P]c3yť䁰bX
2it,,X_iOPuO'ӗ55
D͵x@dfqp }M˨? / W"L_wq:?g[*"I,b#Tj~mՕ~[u8Gl0ڮvkHBO [֓fow kK.JBNkC&?0j-Y *̝KX)= {p)? Y~P6nU/k8QWͨU ;aQ-Jn-;`OՃ$euZاW3Gd$Z<q; GYn˪[U3z;\?6ë 1T -8s
C+8Ssʜn\ ,ex` ;hݱŋj1i{|(A_ \d}-^ քh~oi7eq;WM!B PK
a#QD f G phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/ExampleFinder.phpUT s@Q_Xn6}Wޕ xm4I hI^"%b#K*Iu{g(._U P393g.WIz>B&~ֻE7>;<BR w¤x z{G:##ɻX8,0/NvR
,! \3-hImO/32eӰe
|A-R}
Eũ8^܃PD/`@d2 ~b^/bkz5 G~0^0:AnVj>ЅY&%=+xCG+8h6OճgZ7T"ERЋ#a6}盇d4dJ
ct s"hQ0#A+rIXΌ{j_ޡQ.{(}x-\o|"a:F 9
Ɉ.q/_[\[p_7њ
D 4FM#)8,3~1coOH*"ߵ 0n,)D^4#2?3 ~!MT(FqȧoXμTnGrʂKQ&k#bp&^ٙ3.˯{֔FP2u;哈;pStCV¥2Jd; +cd\rcoPB 8,Xu}\J&~3Y\/#O8Wm{ls
x,!RfVT%EkR繩k al]~ʱdZ}59SU? me4A4
u 6+ )W4SlBJх Gx`LvӚ10;͚ 4V.Yh:I/P0wGhG]*rBY?iq>{šD q
;yl56GL]s3ߎ`p%+wB>]M0K 6/ԾBs5 ' @S>EuH:Apu1ɐW]Gц/ r&V1" YoӲ7o>Ƚ;ťXlo2rf(uOczhWIAӟn-^R?~E~MӓCJL6* ϩN6@!֢iozwyI{4Zq2~HL++mm_"RC7iftlʾ"qF!mdž a!%s
|A
^e ?jW kY Ե:e6ۃoAzPK
a#Q6R+ S D phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Serializer.phpUT s@Q_Wn6}WL,,b߲:i6)v-QHt(uV33\|2hA=D'S0/.&p}"!NR
ǀxXd).f5 i
!_E+ ,4 )\dD%cp{yu]xjO QF=\$/DH1PD ӄ=^j> # θdHFeNФW4)mPSg'靤Yܛj R/v`d.T'AsJ{Rp7ظ@@Ăg8x?*P 5Bժ<Ӆ# ´$Y̴R
E$Mbu`\>VkMc$,N5*L;ֹ
AtSbUHٖ
z *PXF0[S}Oѥ 'B*
5)exJri #y0f(\ /yK0.MLCuY
TEv!og>5Ԅn0&`P(պHf&X> ]i4WVp&; \ +;Jw@MCܟ{|1pْ-n{H\oklZgxD4&Ec :DbgF{BEI=E=`^}Q华x%;qX+JEWϮˏ]@gQaXXKm-gօLʥzǢ ʢ%^^S~h_z|Qgʨ(IoOC#jxo7
y+Fz}\
Z'K8LwT5OLJ*1w`b 6.|g$f-<Ԕ8
yia>X,+7L&
},d*VZ%'iA3~kAt[鋛l,h KkEFP#^v0q]YF
>Q$ף^cf nvo9l݊a ΐv%3
rwI̒)k9;vطdmz m5wפҮ`>mm 6dDH{(({7¾}
^aIl-ȖTh\\ u K-GosAHv6SRۺl|W8R7[9[ z ;EyCʺUҾ[ 94+ )` 5ǦWC(S{
[ qozƴNm'3R k6KvjM?'S
>t:0qWn|
;(*w5&PK
a#Q s
S1 L phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/StandardTagFactory.phpUT s@Q_[[w6~@{|**+ۛru 99fϱ\"!k` ҊߙM]X3~0_elo/as"dBx:|w {.b8 fˆ~N朥F3.&4?4q#1S)㎾sl j*ic`H!&IqZUjk0|%[Bۀ;Qwq=v=GV3 a8sm ~ Ha9 j\{az<=gPk*747X۾CiO#@[T .Tqsa2woČ< BeގHHuMV"# RԀWj>|Vq}ڮ;sAV꧃ ۧ^56W ;#ZF[8ꎿzdZձ^i-z\ 7<>^ոf44تcGqQ`JLLd1Ye&l hnɪ{{pr#VA;?0&1NCnkW2 ӅpeJ=gpT?L37IF#3 *Px=ņaOe.s)2j ]7[j
Wם
ޅXN4
5fVX{jL ~{ ءi! jpWMGkeh4ÃQ=+uE6H+3eIQ"rwQKx1B4% A h#znC9+ 7uwں1fJL0Xzs\n/ fQ ٜ@/֭YG(4 )dP z6V"D2@Y3uRׇ Wgb hP6wsR$sMOҮ_`>L$o N/-o2>0dVc)kd7φCкv {ߘDΤL O)yLJ%0i܉C#x)T| {y%3 *="nRT*EX{ɚםZ2F{ nqLEq-2^WCsG ll oIN%$>2i IilG|+Vt[dV
/ߴ{h%IT+v2{0To,
ΥΔt 4G-5W7'X 6Mδ!:&<NJrEG؍$m.Hۇ4 $@gh D!v[R-Y箬#4!~F`Kaug!(͔ŘĔC{,,H>v
:=3 & W䢄j^=6c<7L~aCf _ؙ LKj]oD|L#f)U9BkO Wi+>Ƶ| B= ģ[73(!RHW}@4*llF_sjN س5P`O(BNcֱy.{Q ~V59̥ˬ
cJf ,3 k}iʽt3GV7|*S)։ecG"<}yGs #TWmy7+e˻TQڡ,QV3}'Q!:aa
eW#B$ˬbs|-_X1Oc+L4j}lahpV<
r l-v& L൏댁m%"GK8I"Ї5yF!BPXb~8ZǞZTk
. Ò,i+p- By'ՄgKfo>qA 5YA&
ye|CC hEzdߤ8\i
c' BLs qՆpgoJ k Gpf
C |[5}ڝ>+(mwsATF
zbZR/Oƶ%$E8G𧌴"X9o ew]:i2͇+1D/OondQi}ⴳ&
7m;?~.^VTӶpޅBM/Zl=PK
a#Q ; phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/UT s@Q_PK
a#Qmq E phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Author.phpUT s@Q_Vn8}WL Fэ㸭0!1N
ZYʤ@RNE R$+JU&rf!<=/(c
m<'7:=)א 9SdIFjHfJ*0)BRdD2P|`"G(4T;fgghm]/>οm(Ϥ=snSលvx@pq RchDc
ۡ _`ad!hC&%jjAAb2 9D[n7)s
FpA%ʥH
mjq߬]/>͖lqbL'n&#+Lj{϶``@ellCWx*Yi? Xz [+QS VX>#O! pIeCl
#bPD9N2 Z9W|bp` O%E_R gIrkŬ=3r wg
4M$/7dPJuD֪ (ʹSl4uUD&j95+tJ.
4:<;WǤJރy0Ē"i[`qPk.CG8|{
#J{-j' Z[I_; .BfzܢU_U'E?wc[Z"w=_l{:,Fg'ΆyDNOt<8ðOKC/D3_K% TG;#Is[>0Uߘ>[|1) sGr'ذ!,?Rh,N5fIЁ3nh}53G߂Vwa0 Q៕Q. +nR*vyvvT_ݵ
a
D.$ɩEh6)j^ PK
a#Qe؋ { F phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/BaseTag.phpUT s@Q_SMo0 WN&Y Eh`PdHD7(:T u]RJL"k7WӥRL
Zxёs !o
_-J2A>5Y@]سCۇ_B֣R t̊]CR7%&B
6uOPk̼PB)k)GӟWhDRʛt4`
Fl-ww uA2̭ }@mxb15:Ha_QY ]LP +:xblD|#QxQÙ ޱ;{p,]ݠ+L nR\DJY@$'SHZ؛S;e{>yҮGGe]qLć 1z! 7G~iTL!=no ;z;&mӾWPK
a#Qt@ }
E phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Covers.phpUT s@Q_VoF~_1'!a>h#\"FUHՇ pU &Wx yڬ(*0XiYz
yrE㳳~])(
D ErDa&FHkkEj*GBnOS6ׯWkek)(*nj,kzC\heQ;u auıHGgT
5ҜV?"߳{eŋrrھym *Q?|'<\ I,wRU\̟܈o/J^- d#nBJԤan/ o*r e..G@#oYqV+I /|&ݛ
Yw}>d7kQDD@ bOL1 _lHYp`:BCb˳:ti%wJ~啮X]}C|MK.t
[,r\SƂA{PRt:=>vk g~S;
߸(@
2su9ʷB_o-( }Kh oE('#f*g]5Wt< Y;L} 0Qn%N 56
2m]LJ^POW?t
aHG1=z;XH2|LOliH X {ϭxeHK, sVzٻ8 t1
J? <
$IPN CGGG`K[0,?n21qkoO;`%B%Hr<. voxΩ8g=!h<E_a\d:䂭XpݔPK %bh D
VXBF|KլIFT,$\`SVLL¿Zܣ! 8يv.B|v@5S`a|7s=Y ZJI)n [&֖KO Z>lx
bFeRt2rCWH)1zI#vT?}kyNfPJ?'!Av/%Xx=iޢƥ8 t[V<". Hdi.vD[675xr& &yv{'§s QV@BTH ,#|se4{ٸȒ- ܄1geE챑i[0n7 CiuBez }W\M7U\`5w|VH봅Y6ewSȐ5C/OFB7feɣݰ y @՞k
:GiUV < ALbYI!p-c/2i{i'jO:5ԶF_m \:A{g<b?sLKQ
NK`|Td%NkuZ\]}~H"}7 ~,H ?1%;cNw;8X1u[ě7yw{n%A;U}g?Ml3 Cc;?/^w8>gKR ?dY{v coDžuX@=S- ? tЫ7PK
a#Q*
F phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Example.phpUT s@Q_X[o6~`R9ܭIMP P-іPYTI*$/\ NsL8" b.69c 1 ' - 1.^аXLP62IyE1A"MQH
KV@8P$ "[R" )pv˛٥ 9nQDpX8-XH@QD*$'"F 4ᐲz 1Y&dP
߃x?L~!59e)>Ûw` wsFVsS; ?,%ڹ S0}SWxtD1 A>p8w'^2x30y!M *. R&G!mD>&"Q'ѻ{$$[OX2(!p4!SNтs4@~JLRpΒ{ g/ )l
7zK ^70Bif p+#\Up2J<' 4]fzP:%\@Ɓ?CyOLe 2Y.SX,ynj>{`/BG Q/
l%T窆ݜO+cMPdRPqƫ!AsIWs
340[_K~^J:;7S!4KB;qTK5B\pO9a6}eU [hJ:o
*7[G'цѠS (\-kjg?
e
+h0e-I$l^ G-Y&2b$?e: `kRBzAxȒ\:PWUFb4BW=|R; еaȩc#4+7
cIRE3[ ~ ^G^>7</~BdVR܄nvi.0#l"u9Z7*¯;U{
6P Z
nN؝ָTjLlsw(t-yӻ3D sf0 /n{S5GV:~] WiMǾOeԣz-]^`>.GcsKx.]*'Rttr `tW (jw "et:(AweTչnl n}[jo%e^}u^d#J{rط=`N +]5sQOGx9 :S24 Ia +Y"2AʌѫWNޘѩi 0Hj 1#Ƶ "{֓UU) 4pև5膶Zu } sWHk |Bm8 Ɠ3zD$R \2Y
ohġw ,KoV
ʕR' LƖȾ-wfWDlۊ~mAGv7xMܾn"¼ڒ e\Z)w= moPK ZW s.bFU\ z00hrPK
a#Q C phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Factory/UT s@Q_PK
a#QP,S S phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Factory/StaticMethod.phpUT s@Q_UMK1 9xEv zp8 63-iKui7ɓ:(FdL*z9b:;Y,,`kl:LNjSHK:$ O
qNv0kpV\!l J5nYR Ip-tD`pYrBnY Q %.!X\48ֹ秇|4HQ&ЦgB
;% 2_wָ²mYjcV'?'ް WWV}`G~SEOuD3H ٳ%Y.t=D T@*.3(2QpvRVC/2 bhkyo 8*vT`9,'ڕ?PK
a#Q E phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Formatter/UT s@Q_PK
a#Qx" W phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Formatter/AlignFormatter.phpUT s@Q_SMo0 W N8Y=l-Cȴ-T N d'SlA= >6U$9J- }rHEX)n#pW+
YqZȼB(ZAfTYVgSXW RL(8Uu߾>
P U`'<*۴9U|\mDnR+TD|Ds+3J'5Fp@;egmQ~u:vo,[=u!TYPvؠ
3Yz*TN w\r+8OCSU5(!x[RBA,
ĈS5=X|AX_0b@JCcm57"P> f=f߿.JJsbuNc8BVv\x䯌pFaf7Gab3) أt2 tsK:}W-7 :| B%>lyV :RuX*Sy/ǐ F- x*8tn/ \jEoKPK
a#Q e.q ] phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Formatter/PassthroughFormatter.phpUT s@Q_RMK1WAūǂM0d*$Jofy3o.B8Nw
Ώ'B4ө)i3 #[o:qưH#tZP>|EkZFKL: IƻC%WPy%J&hMQȄ- isTȃZ*}@
MN^|)HYaEUt9{m>^i϶;JW]EaOߢ_+1ݔR=qo̲rt !U"C.'cb
GSߐ_+Ǽ 0NQb33 ]`VG=1pf 6A&9y19P.Δ6E:(] ԏbSI{.i EZJBayMi2t"p()ǯz-n28R,2>gtHjVO Qo0[=>_x[IOo×W(uM|~Ё /BjlI˹ءMAQ9CHPg>T +
.2>7Y+b`-(Ƣ[jJ1Wz#I^XDP?cM ^˯"e?Ks%RQ7û(?{g3r'u^!.\z4ue'ī
p#]\m"/h<ZvͺՙmC9TQ[
"xB jyēE_ZMDNWaLùK;(&vVCCq [o5 Ge:0 j`JglhU Sm3m%'9\&\FB%{ΘoĮ`N+ZͰDq ݮx( Tɟt
T8MyfI tﱇU. 9naq
#+KC
mҠPpHqܰ?-gݺKفp=QOUo ڍt|Z#RkM +t hv62;bE5F&7w#eܭ vA'ē&J9CT¬@hnhsGBѺ.&ޥU)p-r
\8"whTOs/PK
a#Qះ% I phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/InvalidTag.phpUT s@Q_WYo6~`/,NҾ&ͱ -E}IMln(Q );n$k w* b3R`o~^FO\ Cߴ(RȜ6A@8W~RZ>E- \ _Zx(2ҟWFoBU$%XK]0;Y
$Tx /7( 97l' ser5~\#M"^']ўtYw=UiV7No^j%E^ۮߗ^,~Nh C9RlT|썪vi>'&d~'0|f^k`gݖkph+-AV}-+~C͝N77CW'E|fL^{~4UC[ ~S{ª:/Ak$@ ncu h,d{3S [7f 'sGwaˬaғMw^
ي+Y_PK
a#QJy \ E phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Method.phpUT s@Q_Ymo8_$e]ٽiۦmHsw8^h[,"ǛEdV_lpv 2"1U9o {w NݬsyAnq]"`DzCJN1 ϴB|Mв.
Wkp"OI@D#-ۜ$ߗ_>^^}> 0CY.[Ԝdh5̀-UJ@QF y 9ߞMǴZ`P
a[ ,k,H*LMOo j0yZI˻l9OUWY>Op=0Zܒl1$Xw$??4o(K;cQ˺lWϿ=s&ݶPpFMpED+g|[ 3];z-u`ƝAдqnq5uAp$ :8OD 7ia\(˨^%.4WEDʌpA Kt4Mq8 <`zf!![ o+(8xCq~;)c"0 _~9ACE} q\rc% Bߙ;B"1H|gv< [+CB{|?K]k!`+ z$O'YrK ~߮|BX<̗胍N아-o6f 6e/D H[8o|"kkL,."*H{w
ޝϚO5K>C;5k.bR
B?I=+ PcwZlG\RNjcST
;[}%]Ξ".! Fא2uRM亝 9jo몒8Te fh"4ǘ9d
CdX1VdVgP<qq:G
HzpUE`"s%6h^&XV}0SFXKR!!08nVӎ 0Y'0W
4BH0͒>T
ͻe2t!oy2Am}}eMBK?
}oG&}:pUWy(
9 4sɉO:azE$4%<Xz¢bM2GA$EB
˕0!ס,@n(|gOϯN(}\nC1U$1R "X#ŤB.OJ|<!ИECƗ?tpMD "$)~HYsv .ڡ!>!"4WY>RmF< R1;f$ /|#5b^RfRdB\h}ȶuwU XYX&$\\38t=?9=y~iٍB9 0 { AK YͰP>(Jh%υ&D,Foʒ=QPwv%1DXܹ8E,&J--3U? PL
W?A;SSE5\ud(S줞Vh쬭N6K7^ׇt
U4/㵏TGގ3v GldLج1w:W+D_Mv-M۲#zS
SjȂgX%n Gl`dMɕOG 2ԅAK-TJw-Rk83_\^_}zwYWv `(r,`Ξ )
bs(9A%. R,,o+;Gx #l
h5p"RATc D_^GEI1͗O9u^EgI#Zl>jl,f ǜ 챚ܰ H֛o7SO @W̩I,Xzl'{C0ӧ=<ۊc 5]oވl}ZJnD]Kz ʤf5B;[b" wS -[Et e4+2JY7Y7B_
QK-^ /a%R[ CK'.тb, `oL::TSLɤ|9-T8iTPppA4J2cH)RH5_%ۊ(1K_4 ([oGKR!z k;߾ #~0pr\3uWቴB/U8!>p.14 7= JY38(- 6!fțŒYĕ:Ah9tvqvSޱufO%Fqt xRj
+Ou)sc5zX OCﲁ7j;9S^e>tƝsέ!j6_c]mwv 6&~b#?:^F9k1k.|UL hv1kc):+AU+-\1깚er~WK
jzFV]7
31ҖW=N`e'#ܖs?PK
a#QOO)
L phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/PropertyWrite.phpUT s@Q_Vn8}WF%e Ggsiw
8<ԅAKMTwH)IVy59sӟŪgDP*b5WۂI7::bjbM0TS)l/Txe %˗-F@
bEFo1sZ.j2sC(cW<L}p
9v,ʜ~X\fqfz<7
QM?}ݮgv"$'M} 7o(@j&VJܞz Ҥ5(]d;K@oӵn{xvӪЏ V(E0I`n
褥suB/ڰO2 j1bhc, `ҬutvM 3BȘ
Q8GiTPpA4J2G#`:R^1/1K;_4&;o't{-Yw~;vAfԯ3a^ qB|]bh6&M\2KpHǞFqÄMf@,Rb zx 8Q8uޱuc@_CZ gG8ò]$Gvpj~o(gU YL6=Մ`РVS ]P
C7gռxvAx)*EYT4.m~rΤ@+Q\RskGiD۱^Ev;?
'm_ /ڽkf}>[ZתF&[zv kc):+AU+-\ 1깚e2r+%~W]7Ɵ31ҖWN{pWϽ PK
a#Q E phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Reference/UT s@Q_PK
a#Q
v N phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Reference/Fqsen.phpUT s@Q_Ok1s6i^5m(
FzEdI ژv&"VOogt=Qӄd
1}(Uf
fuGM
ۢ@Wr-߄@-B9&Mˠ}
I2|h ѡ}qq_JEn5^'m[w5-M
J5 sg *FJ);6MfZYoRvt =jW>
5@jX ua( cz-u:!nٟUԫY 3WJ$ӌp [ˠd~ jew'2-L^y$_
NY:-Lܑ ^h%1ٸ#4P.O?>*բqp#w <6Ag QC@_zt-@=Bgоg
$ 4hPlkqWy, U ;%:3FҤɠ8x0w?A gөlT)LQ w gS7,:$!O)Sr@g 4]" jz-=:RV .Գ9b&(5Maq$ՌpJ:k "_a2 + =x9LJfGCy?Л |2ۓi eaYFc%LY~PK
a#Q." - F phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Return_.phpUT s@Q_TMo0 Wp@8E`di~ =,Ct,ԑ Ind;tCl|{YQ ϙX-]Mfy0QGp `ڂJR//(C9`3sh,0@.8JC%dY192= |y߿]\]R͘gf ݲ!.F#5Jap ʬ-ƣM *(l`a~iSr~o}5 YV-V9
=2BNPW `ؑ&8
,@$zE$dEeJcJnc_\} `K)HWjlvr,ӄЯ&O\=̷`=C
t?~.YwEݡ+-U9Eg* j ۵`UV o*
` 4fX*{Cl0y N
g-nET\hiqtZӦbDt
S]Mzڀq}Yk'vV]H&V K7b}mB5 @ #q-`N VgViH Vh x[UaMçkIejf`mPK
a#QGP B phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/See.phpUT s@Q_Vmo6_qX kiS&K]Q)a. F:DdR#$n;J(ۛ DsGv^-(1+:#37s
U% BZ(d@J R}fLb,y
B*Kt6rp TPY2
mIFP(hNOls ^X%Y9^W&CrE)-,$!("%h+A*=+,JҔvߔ:^Sߡ͌xWI
[T@9 A;+Cs@:}'K[7KX=Zl aR^1b= v X[ψ٢kPYj,ţEbS }i {RQE*UJ &Ѡftɲ?-t }~.n&5gü]w sO- =gONR~C[,7n#
]fL+·\yl <8ʃ3P4uh .Z:nIͅk(l};A0n6I>zN[ C ;%z6{;zA'Q,j)/4,EiDb ?æ>e|X[)M듪. $Ss2Y
FM|dI^]\xIn+8jP8 [.X+HnY&ȞOÓ, #O : A2
c5-b^H;Q/ % v6=撥w;>!w 6l}v8\2yݡ]XH a]3pA 9q"u6H&1!mt72U)d y =BCʛ &=mѵ#6o[EDChf 8{:7ֶq}vvAfήǤr4qؕ%]ii0[~!s۩l1܅gg섆bhwOi9d:~sS PK
a#Qe0 s
D phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Since.phpUT s@Q_VmoFίH 1~tJHqI- 2&ά. l33(fVȂ̒JāZC}j
z`%Dq /P# K'.@mDy@7[~B,h"*i ٓx2OȔ'_BuXO b<CG!;"N*
ypA;&3 !x3%, \ $[{-41Gl9~nÎqR@b[*&VxeF[ kw)%Лʯo5xt n<`RE^G\O~v 4(ZDTb1ƌu0.e C*X~҇Q>
[~)*Zu싘r5e`
GZ7bMu$k#H5 3bFx<kTX-T.RH")±*+$1%q:OX&!$q /c KЧ]ZozV?}aЭr!2"X$G! \&qIMF#`G[Ozp`p-m/#\ w( gUIѼQY^TWU:(_ peQrd 7w \*A)lP,
J jFq'ʢ$4Rvo֖2Pƹ\H/ oJ˝A:(8L.|O`l^ӋSIŊO+ T 8 Q LWsB,[ ţrXwD XLJTrr ʯrl ^ګ6%~TVwGqD$Rȑ)`"^Q$G
U,CW4 #"N
4{ ' B>"ROQ
XDu'4ۚGP8pK5j]؝Cf4TjM(Qw4TMM˘I2G ,v{b?Hu圬[p?8zTt<+T3 zAB.%0Ywd@2gzɽue9Ys:Բ
h azӉI1^S^ | v R o8إ?3컽ȿڃ25z(\+ҲJ|G7.~
ƻ.Lnj`ՑfpABJ*~|\ ,vliY[cڃ>M єzNA0xpTO ,uLB5쉸_;s<̎IcX%B#mK
՚o)]pc _{ҒmwvLk*2vmð-0pZj i@nZh )_l>=F,-Z$XE3&c9 `}PK
a#Q5r J phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/TagWithType.phpUT s@Q_SMO0W̡" -tJZ@살im\gXvd;@wiiS'y|dtQu(+a1q* F7fQ4<>KP=ka=(7X%BTHSZ ΡR0v)2z u'!?9U, 9<+_8XDVe#Sz_
$47هQ]-(S
%zU8 G}h'ԯ, JP ͜j]` h@G3!G; F\2
.D2Z[I,حoxR7V0 sf2*1!`Pw5I^0>6y;=W^Lf]ڷj5@=n15+6\l?` ql پLǐ^'-_F0Z mH/KRll3Qtu¢$$i!
EuuxOUNvX0G ℯ _,HD~?{ &{
D9|ZEu|VaHڿ]Rp4f'4褚mu PK
a#QoVU E phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Throws.phpUT s@Q_TMo@+!Jl8͗T!C]Ee0(x.q,)> ̼Ӵʫ HLa*y2
c<I '0
YQ"Ŕ^K^P[Y]eQ27D
eQh*!2VRBU"K&뗫[grf`4e
.LNOHR\xʍшZQB]1;a~YSy>cKM{{ר** -#sFrZ/+) $4@{tX_$ָ{c_
E|B`bkr% ["
;!++۔CRS) $\XE,q
ÿeU {cĥ DMК!LY6n
έcn5Ú=aOn +d]QN% nNwѩ cwrszؾXu^y{P
(4Mg$,:`؏Sފ~=I KV%m*jH;;W.z÷em j)4 # oD+oD}S d ulKv{@8ߑC`ab) v PK
a#Q) T
C phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Uses.phpUT s@Q_VMo8WLl?h"Nu`"ZJ;hݺk $
g <^AcV1Ҳ\ojT*F\ݪTP]k&5(Ț5r-܌獐WESUz#J9Te\/\3]
@]!#cO6w L?(^1
OLA^vFcO^
qQF9\W%u:\dC!4
֨jF!=[,* YV"{ݱ4wߣdYaymD E%Gg|LgL-R` L7]Vk41K).bp LJ?fIuuE=+n6h$ -L5EY?y-ĬIp& 泩&)fQD ~ #94\K p`tc
XlNI,PR yKVMbFՔ-:fAg_<5 xOV0Ƚ1p:l465Tp>z
|Vv:4F `!MY'= *9 (Γ9 2wzYRPX^ZM) E >\b|[R3GkRӺ*ufѴ WxJԍibWVgk[>ٗ3R^ /߸9{L ="+Ax$ ,xr$LNϴ̆ '=0yW70MMAw~dY@p2F&tw '5$Q Ɋ.>~tk};#4d7AZ53~ֶ]l:ǏD:J'RݡBX^-1ӱYxآ{ `r9ՖJJ_"nqM,Ň;BoL&<:KHnc# ?wPK
a#Q!N2
C phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Var_.phpUT s@Q_VmOH_1'Eͅxi!(B *Īv\̮{m8xvvgi{)WZ&M W8I9I
"z!b3-HRH+q|#J"Hg
Mdk
O9CC ͽtB?b (!tB ĢD!C"Ep&O0J|<!HC!x>2*gx av㔇kOR!zWLr +,D+719oPJ\AUE/̒\TYo|bY>*wa\d0)fVI}Rd]g:O1
)B.TSX,PnȔۻ?br}y~ݤ* PXX ~=?0drw`A
W&l,B&hsMATcՇ^G%0\Qug˧]Y.FlX}H"7Xp bmUQ0ejԚt/ԠS%ZB?X8 S PmE 1R#DfK٠,hZJ8H)'=;$*Prs!`'=w{+tZj] aR cP= 玳%#ܖs?PK
a#QN~82
F phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Version.phpUT s@Q_Vms6_G=c#f p\z3m. Lc-'H2 w%o4`[ڗgw]80
`I(V>ư7m!NR&ƀiXH&(sQLJ~ Ė@\)4?ddIH2&]
OI{<*߿N74m 1%ݺ$DlpZT.${7 "ƈ.e<FTg$NI(!{_)(LxȒ\n/ARw4.f*,3#hK=iJn&[UK2-j^2GR I-L k[3U2M LyQ3${fe$`CQ`N wGy7S;->#hq0,ϵ]mV+UvV kV*X~e VW>J G~*76WVorq+F$)EWQ +.6R*WMD 2ykuk $븪t3/TYQ'2$ّ( u&#`dxNV H@cC3 mkݶ: m36x:37aQ 3T^?4^93߮V=% |1X2];NsueML!ck_;s;J4N"ddR~Ճ:ngi9^$ @FݛɻV+AˆWNBS%?j
}pvB& @RjɲNzv 9Qv+ Kb^˂1ٲ᫃Z %YPK
a#Qהf E% @ phpDocumentor-ReflectionDocBlock-069a785/src/DocBlockFactory.phpUT s@Q_Z[w۸~@bR zSI=vN > Iy[l; Ite0|afw<8YRQ$7Ӄx|@&dgIyEQ*'ՆU$*'7yL$b "?"e(m }
E
$NPe]<$z@QF8N8#(*b%%8~k;
*gƎK呔ljy|@Ml%hu e&) 7m lI3`Q)y̖կws2q B3-R8ýG,Kr`gňҕo 7Lqc l tI+pRzt@49>=2{'ݯ3 agOwgc :o#0mH܁8wٹWm
jXק9!'㟛9uHjyG.VdUYN^d&
1nh ǔe+=ڬk*{YdHAQ}7$qh?)
Ĉ/aC"H@ H C40YFi%i6tL0̖xa&ĄkǘT:ٲ\Z4z{l>ļ
/
b>=+ߏ O
gNN&-3z;ə_3sޞZP\(`.$/.QIePFPmRr>*O3l ,,R,!\C&HZb}|8 z2W&yHX`<=
8/1< QgXFq^!|C
ENȶHʾ &*n)$UP{-y@p#n2QRhJ1x ؎ wlc8sr`x8'a'4 6х& E ڕNwM3Z S{H3f:E4@E >/ #_bv]@_:J]E3b8!55k #tCpɯ!G>_.x1b87 2c0[iZlXf-j X$D a)jUs,#/|{
CF{4;ލqN>%l!*IXJelA 4p=byl }*mԁînhɃ\ ,aG0 G*Q,F43VLu&y#- +87k'ʣv,oP?־ /ϓ@6pÝwYQLHAؕO`m8:{I S~ '<0dR 4K2&E|uZ gD-HE뭻[ s:x uJ"B]r5 b>hCP[ bBA)%_RI*]l#I
_O # P"D4܌:![8?L_
*X텎Ļ ` {0W SQPU>7T) (ƌv" !EՐ$U!3[2uS, M:
f! 3Ϋ$ \-VVEeDo7z(Du$G,R{pfu\\хByƙ`Yq^_Q@%pv}GGPU(8Lߡ TssV$rYy꺁o4\u)0=ⱛ dYya8 _} ǣ0] xߺ :xAfa@v:bzĽr=g q+d!Zs;~p?Y.YD9m՝%>VxuNdȅ@~(/YC>U$\IA(^ˈv%`r&MGla/UrVdb= 8; B @ޑ; ci8[CwU.eH3IQC ^p] ԥ' _PHNQ~^7_KܺUG;ٕ}6UU1Y4Ռ MI9*X
FkG Q}ZdC{d s h״ \J*FU8 J%~gY#5};϶ڍc@P$p𱏼zϐ1ٗ_臫8ǫK3U5͂Ld)Lv # /ڻ$B u"^5n8P'1 ם\p5^px .i>:jǢ?HZ6ҭ\3]H &!. E0
i
c K"_e@Hvĝu iu,u F'd\J> oPK
a#Q`U w I phpDocumentor-ReflectionDocBlock-069a785/src/DocBlockFactoryInterface.phpUT s@Q_uRMO0 W6M\B8B^v4V 4A.vg%E/P$
z赌*)̮{!,J s2d' ɨeP
5No73v42un'XpƥSVWå( ש$RX.SyĂu2}{L-B ZNA<
%jSM @ﱚ֢| |uMy :@hG-h <%ɒm #钺͈>0 /dy/k I}?
t/>D,6. y6uf`1p : s\'[ PK
a#Q 7 phpDocumentor-ReflectionDocBlock-069a785/src/Exception/UT s@Q_PK
a#Q4ZU\ H phpDocumentor-ReflectionDocBlock-069a785/src/Exception/PcreException.phpUT s@Q_SMO@ﯘ ͠QL,FҬ۩lhwݭ` mB#:uC LgF=Gsݽ%D M8#/2V5$Enk1/3G/ B X*~'pr% ARwD9#9=Ep|s KH0 }:OS_ Wtg9H"$K9k , ' el" \K*8ˬ{$ WY k-6ҞL*.`TEJav
x#Zgnӫh -A:ƷVR Tmyֵ mJ3Zw1 .|}g s-߶2{{
xY1&HZɭT;Y݉zSr PK
a#Qg2 2 6 phpDocumentor-ReflectionDocBlock-069a785/src/Utils.phpUT s@Q_Vmo6_q(6\;.hu0(dqHzmH)~i
l`K;qEQ(Dd\ŭpq6~Uɤ 7*@4;#h{+M~Fflyi=i֫uA
h0ʚ)8=(ܤ}W7w vb#"lDJ1XFņVKH@ het51VVά_(h18AB|Fɼ(.xDӫLq"zosiE ڽ!|QRBF҄ ҡZpX(|M7/CJe_a}o;lɵ ^[lj 5%+gҶs*eYu+d q^j[[
| %eF, gK7CPFb.V~t"JE80j@TuZ-V $2{y? 喤!V (e`1tl88yw]I/qG]Ѭ )Nݜg~{_s 0 T|[ p #^cpj
..&Ux H- ʣ ctۗ3fPK
a#Q ) phpDocumentor-ReflectionDocBlock-069a785/UT s@Q_PK
a#Q| 8 0 P phpDocumentor-ReflectionDocBlock-069a785/LICENSEUT s@Q_PK
a#Q.=xc
2 # phpDocumentor-ReflectionDocBlock-069a785/README.mdUT s@Q_PK
a#QLAw < 6 phpDocumentor-ReflectionDocBlock-069a785/composer.jsonUT s@Q_PK
a#Q -
phpDocumentor-ReflectionDocBlock-069a785/src/UT s@Q_PK
a#Q/qH { 9 [
phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock.phpUT s@Q_PK
a#Q 6 phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/UT s@Q_PK
a#QO
E 1 phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Description.phpUT s@Q_PK
a#Q:z . L phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/DescriptionFactory.phpUT s@Q_PK
a#QD f G phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/ExampleFinder.phpUT s@Q_PK
a#Q6R+ S D O& phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Serializer.phpUT s@Q_PK
a#Q s
S1 L + phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/StandardTagFactory.phpUT s@Q_PK
a#Q1l = <: phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tag.phpUT s@Q_PK
a#QI41 { D < phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/TagFactory.phpUT s@Q_PK
a#Q ; A phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/UT s@Q_PK
a#Qmq E
B phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Author.phpUT s@Q_PK
a#Qe؋ { F (F phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/BaseTag.phpUT s@Q_PK
a#Qt@ }
E H phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Covers.phpUT s@Q_PK
a#Q#M 5 I L phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Deprecated.phpUT s@Q_PK
a#Q*
F oQ phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Example.phpUT s@Q_PK
a#Q C X phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Factory/UT s@Q_PK
a#QP,S S pX phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Factory/StaticMethod.phpUT s@Q_PK
a#Qv=,+@ H =Z phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Formatter.phpUT s@Q_PK
a#Q E [ phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Formatter/UT s@Q_PK
a#Qx" W X\ phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Formatter/AlignFormatter.phpUT s@Q_PK
a#Q e.q ] ^ phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Formatter/PassthroughFormatter.phpUT s@Q_PK
a#Q[ F ` phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Generic.phpUT s@Q_PK
a#Qះ% I &e phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/InvalidTag.phpUT s@Q_PK
a#Qt C j phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Link.phpUT s@Q_PK
a#QJy \ E "n phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Method.phpUT s@Q_PK
a#QĦ D w phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Param.phpUT s@Q_PK
a#Q8 G O} phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Property.phpUT s@Q_PK
a#Q? i K s phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/PropertyRead.phpUT s@Q_PK
a#QOO)
L phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/PropertyWrite.phpUT s@Q_PK
a#Q E ь phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Reference/UT s@Q_PK
a#Q
v N = phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Reference/Fqsen.phpUT s@Q_PK
a#Q . R M phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Reference/Reference.phpUT s@Q_PK
a#Q L phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Reference/Url.phpUT s@Q_PK
a#Q." - F ߒ phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Return_.phpUT s@Q_PK
a#QGP B phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/See.phpUT s@Q_PK
a#Qe0 s
D ~ phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Since.phpUT s@Q_PK
a#Q BKa
E phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Source.phpUT s@Q_PK
a#Q5r J phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/TagWithType.phpUT s@Q_PK
a#QoVU E ɦ phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Throws.phpUT s@Q_PK
a#Q) T
C phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Uses.phpUT s@Q_PK
a#Q!N2
C phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Var_.phpUT s@Q_PK
a#QN~82
F phpDocumentor-ReflectionDocBlock-069a785/src/DocBlock/Tags/Version.phpUT s@Q_PK
a#Qהf E% @ phpDocumentor-ReflectionDocBlock-069a785/src/DocBlockFactory.phpUT s@Q_PK
a#Q`U w I phpDocumentor-ReflectionDocBlock-069a785/src/DocBlockFactoryInterface.phpUT s@Q_PK
a#Q 7 H phpDocumentor-ReflectionDocBlock-069a785/src/Exception/UT s@Q_PK
a#Q4ZU\ H phpDocumentor-ReflectionDocBlock-069a785/src/Exception/PcreException.phpUT s@Q_PK
a#Qg2 2 6 phpDocumentor-ReflectionDocBlock-069a785/src/Utils.phpUT s@Q_PK 4 4 ( ( 069a785b2141f5bcf49f3e353548dc1cce6df556PK ! ܵ\# # type-resolver/README.mdnu Iw [](https://opensource.org/licenses/MIT)
[](https://coveralls.io/github/phpDocumentor/TypeResolver?branch=1.x)
[](https://scrutinizer-ci.com/g/phpDocumentor/TypeResolver/?branch=1.x)
[](https://scrutinizer-ci.com/g/phpDocumentor/TypeResolver/?branch=1.x)
TypeResolver and FqsenResolver
==============================
The specification on types in DocBlocks (PSR-5) describes various keywords and special constructs
but also how to statically resolve the partial name of a Class into a Fully Qualified Class Name (FQCN).
PSR-5 also introduces an additional way to describe deeper elements than Classes, Interfaces and Traits
called the Fully Qualified Structural Element Name (FQSEN). Using this it is possible to refer to methods,
properties and class constants but also functions and global constants.
This package provides two Resolvers that are capable of
1. Returning a series of Value Object for given expression while resolving any partial class names, and
2. Returning an FQSEN object after resolving any partial Structural Element Names into Fully Qualified Structural
Element names.
## Installing
The easiest way to install this library is with [Composer](https://getcomposer.org) using the following command:
$ composer require phpdocumentor/type-resolver
## Examples
Ready to dive in and don't want to read through all that text below? Just consult the [examples](examples) folder and check which type of action that your want to accomplish.
## On Types and Element Names
This component can be used in one of two ways
1. To resolve a Type or
2. To resolve a Fully Qualified Structural Element Name
The big difference between these two is in the number of things it can resolve.
The TypeResolver can resolve:
- a php primitive or pseudo-primitive such as a string or void (`@var string` or `@return void`).
- a composite such as an array of string (`@var string[]`).
- a compound such as a string or integer (`@var string|integer`).
- an array expression (`@var (string|TypeResolver)[]`)
- an object or interface such as the TypeResolver class (`@var TypeResolver`
or `@var \phpDocumentor\Reflection\TypeResolver`)
> please note that if you want to pass partial class names that additional steps are necessary, see the
> chapter `Resolving partial classes and FQSENs` for more information.
Where the FqsenResolver can resolve:
- Constant expressions (i.e. `@see \MyNamespace\MY_CONSTANT`)
- Function expressions (i.e. `@see \MyNamespace\myFunction()`)
- Class expressions (i.e. `@see \MyNamespace\MyClass`)
- Interface expressions (i.e. `@see \MyNamespace\MyInterface`)
- Trait expressions (i.e. `@see \MyNamespace\MyTrait`)
- Class constant expressions (i.e. `@see \MyNamespace\MyClass::MY_CONSTANT`)
- Property expressions (i.e. `@see \MyNamespace\MyClass::$myProperty`)
- Method expressions (i.e. `@see \MyNamespace\MyClass::myMethod()`)
## Resolving a type
In order to resolve a type you will have to instantiate the class `\phpDocumentor\Reflection\TypeResolver` and call its `resolve` method like this:
```php
$typeResolver = new \phpDocumentor\Reflection\TypeResolver();
$type = $typeResolver->resolve('string|integer');
```
In this example you will receive a Value Object of class `\phpDocumentor\Reflection\Types\Compound` that has two
elements, one of type `\phpDocumentor\Reflection\Types\String_` and one of type
`\phpDocumentor\Reflection\Types\Integer`.
The real power of this resolver is in its capability to expand partial class names into fully qualified class names; but in order to do that we need an additional `\phpDocumentor\Reflection\Types\Context` class that will inform the resolver in which namespace the given expression occurs and which namespace aliases (or imports) apply.
### Resolving nullable types
Php 7.1 introduced nullable types e.g. `?string`. Type resolver will resolve the original type without the nullable notation `?`
just like it would do without the `?`. After that the type is wrapped in a `\phpDocumentor\Reflection\Types\Nullable` object.
The `Nullable` type has a method to fetch the actual type.
## Resolving an FQSEN
A Fully Qualified Structural Element Name is a reference to another element in your code bases and can be resolved using the `\phpDocumentor\Reflection\FqsenResolver` class' `resolve` method, like this:
```php
$fqsenResolver = new \phpDocumentor\Reflection\FqsenResolver();
$fqsen = $fqsenResolver->resolve('\phpDocumentor\Reflection\FqsenResolver::resolve()');
```
In this example we resolve a Fully Qualified Structural Element Name (meaning that it includes the full namespace, class name and element name) and receive a Value Object of type `\phpDocumentor\Reflection\Fqsen`.
The real power of this resolver is in its capability to expand partial element names into Fully Qualified Structural Element Names; but in order to do that we need an additional `\phpDocumentor\Reflection\Types\Context` class that will inform the resolver in which namespace the given expression occurs and which namespace aliases (or imports) apply.
## Resolving partial Classes and Structural Element Names
Perhaps the best feature of this library is that it knows how to resolve partial class names into fully qualified class names.
For example, you have this file:
```php
namespace My\Example;
use phpDocumentor\Reflection\Types;
class Classy
{
/**
* @var Types\Context
* @see Classy::otherFunction()
*/
public function __construct($context) {}
public function otherFunction(){}
}
```
Suppose that you would want to resolve (and expand) the type in the `@var` tag and the element name in the `@see` tag.
For the resolvers to know how to expand partial names you have to provide a bit of _Context_ for them by instantiating a new class named `\phpDocumentor\Reflection\Types\Context` with the name of the namespace and the aliases that are in play.
### Creating a Context
You can do this by manually creating a Context like this:
```php
$context = new \phpDocumentor\Reflection\Types\Context(
'\My\Example',
[ 'Types' => '\phpDocumentor\Reflection\Types']
);
```
Or by using the `\phpDocumentor\Reflection\Types\ContextFactory` to instantiate a new context based on a Reflector object or by providing the namespace that you'd like to extract and the source code of the file in which the given type expression occurs.
```php
$contextFactory = new \phpDocumentor\Reflection\Types\ContextFactory();
$context = $contextFactory->createFromReflector(new ReflectionMethod('\My\Example\Classy', '__construct'));
```
or
```php
$contextFactory = new \phpDocumentor\Reflection\Types\ContextFactory();
$context = $contextFactory->createForNamespace('\My\Example', file_get_contents('My/Example/Classy.php'));
```
### Using the Context
After you have obtained a Context it is just a matter of passing it along with the `resolve` method of either Resolver class as second argument and the Resolvers will take this into account when resolving partial names.
To obtain the resolved class name for the `@var` tag in the example above you can do:
```php
$typeResolver = new \phpDocumentor\Reflection\TypeResolver();
$type = $typeResolver->resolve('Types\Context', $context);
```
When you do this you will receive an object of class `\phpDocumentor\Reflection\Types\Object_` for which you can call the `getFqsen` method to receive a Value Object that represents the complete FQSEN. So that would be `phpDocumentor\Reflection\Types\Context`.
> Why is the FQSEN wrapped in another object `Object_`?
>
> The resolve method of the TypeResolver only returns object with the interface `Type` and the FQSEN is a common type that does not represent a Type. Also: in some cases a type can represent an "Untyped Object", meaning that it is an object (signified by the `object` keyword) but does not refer to a specific element using an FQSEN.
Another example is on how to resolve the FQSEN of a method as can be seen with the `@see` tag in the example above. To resolve that you can do the following:
```php
$fqsenResolver = new \phpDocumentor\Reflection\FqsenResolver();
$type = $fqsenResolver->resolve('Classy::otherFunction()', $context);
```
Because Classy is a Class in the current namespace its FQSEN will have the `My\Example` namespace and by calling the `resolve` method of the FQSEN Resolver you will receive an `Fqsen` object that refers to `\My\Example\Classy::otherFunction()`.
PK ! 8 8 type-resolver/LICENSEnu Iw The MIT License (MIT)
Copyright (c) 2010 Mike van Riel
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.
PK ! % type-resolver/phpbench.jsonnu Iw {
"bootstrap": "vendor/autoload.php",
"path": "tests/benchmark",
"extensions": [
"Jaapio\\Blackfire\\Extension"
],
"blackfire" : {
"env": "c12030d0-c177-47e2-b466-4994c40dc993"
}
}
PK ! qM type-resolver/composer.jsonnu Iw {
"name": "phpdocumentor/type-resolver",
"description": "A PSR-5 based resolver of Class names, Types and Structural Element Names",
"type": "library",
"license": "MIT",
"authors": [
{
"name": "Mike van Riel",
"email": "me@mikevanriel.com"
}
],
"require": {
"php": "^7.2 || ^8.0",
"phpdocumentor/reflection-common": "^2.0"
},
"require-dev": {
"ext-tokenizer": "*"
},
"autoload": {
"psr-4": {
"phpDocumentor\\Reflection\\": "src"
}
},
"autoload-dev": {
"psr-4": {
"phpDocumentor\\Reflection\\": ["tests/unit", "tests/benchmark"]
}
},
"extra": {
"branch-alias": {
"dev-1.x": "1.x-dev"
}
}
}
PK ! ҟn n type-resolver/src/PseudoType.phpnu Iw `
* 2. `ACollectionObject`
*
* - ACollectionObject can be 'array' or an object that can act as an array
* - aValueType and aKeyType can be any type expression
*
* @psalm-immutable
*/
final class Collection extends AbstractList
{
/** @var Fqsen|null */
private $fqsen;
/**
* Initializes this representation of an array with the given Type or Fqsen.
*/
public function __construct(?Fqsen $fqsen, Type $valueType, ?Type $keyType = null)
{
parent::__construct($valueType, $keyType);
$this->fqsen = $fqsen;
}
/**
* Returns the FQSEN associated with this object.
*/
public function getFqsen() : ?Fqsen
{
return $this->fqsen;
}
/**
* Returns a rendered output of the Type as it would be used in a DocBlock.
*/
public function __toString() : string
{
$objectType = (string) ($this->fqsen ?? 'object');
if ($this->keyType === null) {
return $objectType . '<' . $this->valueType . '>';
}
return $objectType . '<' . $this->keyType . ',' . $this->valueType . '>';
}
}
PK ! # type-resolver/src/Types/Static_.phpnu Iw valueType = $valueType;
}
/**
* Returns the value for the keys of this array.
*/
public function getValueType() : Type
{
return $this->valueType;
}
/**
* Returns a rendered output of the Type as it would be used in a DocBlock.
*/
public function __toString() : string
{
return '(' . $this->valueType . ')';
}
}
PK ! | | ( type-resolver/src/Types/AbstractList.phpnu Iw valueType = $valueType;
$this->defaultKeyType = new Compound([new String_(), new Integer()]);
$this->keyType = $keyType;
}
/**
* Returns the type for the keys of this array.
*/
public function getKeyType() : Type
{
return $this->keyType ?? $this->defaultKeyType;
}
/**
* Returns the value for the keys of this array.
*/
public function getValueType() : Type
{
return $this->valueType;
}
/**
* Returns a rendered output of the Type as it would be used in a DocBlock.
*/
public function __toString() : string
{
if ($this->keyType) {
return 'array<' . $this->keyType . ',' . $this->valueType . '>';
}
if ($this->valueType instanceof Mixed_) {
return 'array';
}
if ($this->valueType instanceof Compound) {
return '(' . $this->valueType . ')[]';
}
return $this->valueType . '[]';
}
}
PK ! $&m m % type-resolver/src/Types/Callable_.phpnu Iw
*/
abstract class AggregatedType implements Type, IteratorAggregate
{
/**
* @psalm-allow-private-mutation
* @var array
*/
private $types = [];
/** @var string */
private $token;
/**
* @param array $types
*/
public function __construct(array $types, string $token)
{
foreach ($types as $type) {
$this->add($type);
}
$this->token = $token;
}
/**
* Returns the type at the given index.
*/
public function get(int $index) : ?Type
{
if (!$this->has($index)) {
return null;
}
return $this->types[$index];
}
/**
* Tests if this compound type has a type with the given index.
*/
public function has(int $index) : bool
{
return array_key_exists($index, $this->types);
}
/**
* Tests if this compound type contains the given type.
*/
public function contains(Type $type) : bool
{
foreach ($this->types as $typePart) {
// if the type is duplicate; do not add it
if ((string) $typePart === (string) $type) {
return true;
}
}
return false;
}
/**
* Returns a rendered output of the Type as it would be used in a DocBlock.
*/
public function __toString() : string
{
return implode($this->token, $this->types);
}
/**
* @return ArrayIterator
*/
public function getIterator() : ArrayIterator
{
return new ArrayIterator($this->types);
}
/**
* @psalm-suppress ImpureMethodCall
*/
private function add(Type $type) : void
{
if ($type instanceof self) {
foreach ($type->getIterator() as $subType) {
$this->add($subType);
}
return;
}
// if the type is duplicate; do not add it
if ($this->contains($type)) {
return;
}
$this->types[] = $type;
}
}
PK ! /fqsen = $fqsen;
}
/**
* Returns the FQSEN associated with this object.
*/
public function getFqsen() : ?Fqsen
{
return $this->fqsen;
}
public function __toString() : string
{
if ($this->fqsen) {
return (string) $this->fqsen;
}
return 'object';
}
}
PK ! b b # type-resolver/src/Types/Integer.phpnu Iw $types
*/
public function __construct(array $types)
{
parent::__construct($types, '|');
}
}
PK ! z ( type-resolver/src/Types/Intersection.phpnu Iw $types
*/
public function __construct(array $types)
{
parent::__construct($types, '&');
}
}
PK ! -bMj: j: * type-resolver/src/Types/ContextFactory.phpnu Iw $reflector */
return $this->createFromReflectionClass($reflector);
}
if ($reflector instanceof ReflectionParameter) {
return $this->createFromReflectionParameter($reflector);
}
if ($reflector instanceof ReflectionMethod) {
return $this->createFromReflectionMethod($reflector);
}
if ($reflector instanceof ReflectionProperty) {
return $this->createFromReflectionProperty($reflector);
}
if ($reflector instanceof ReflectionClassConstant) {
return $this->createFromReflectionClassConstant($reflector);
}
throw new UnexpectedValueException('Unhandled \Reflector instance given: ' . get_class($reflector));
}
private function createFromReflectionParameter(ReflectionParameter $parameter) : Context
{
$class = $parameter->getDeclaringClass();
if (!$class) {
throw new InvalidArgumentException('Unable to get class of ' . $parameter->getName());
}
//phpcs:ignore SlevomatCodingStandard.Commenting.InlineDocCommentDeclaration.MissingVariable
/** @var ReflectionClass $class */
return $this->createFromReflectionClass($class);
}
private function createFromReflectionMethod(ReflectionMethod $method) : Context
{
//phpcs:ignore SlevomatCodingStandard.Commenting.InlineDocCommentDeclaration.MissingVariable
/** @var ReflectionClass $class */
$class = $method->getDeclaringClass();
return $this->createFromReflectionClass($class);
}
private function createFromReflectionProperty(ReflectionProperty $property) : Context
{
//phpcs:ignore SlevomatCodingStandard.Commenting.InlineDocCommentDeclaration.MissingVariable
/** @var ReflectionClass $class */
$class = $property->getDeclaringClass();
return $this->createFromReflectionClass($class);
}
private function createFromReflectionClassConstant(ReflectionClassConstant $constant) : Context
{
//phpcs:ignore SlevomatCodingStandard.Commenting.InlineDocCommentDeclaration.MissingVariable
/** @var ReflectionClass $class */
$class = $constant->getDeclaringClass();
return $this->createFromReflectionClass($class);
}
/**
* @param ReflectionClass $class
*/
private function createFromReflectionClass(ReflectionClass $class) : Context
{
$fileName = $class->getFileName();
$namespace = $class->getNamespaceName();
if (is_string($fileName) && file_exists($fileName)) {
$contents = file_get_contents($fileName);
if ($contents === false) {
throw new RuntimeException('Unable to read file "' . $fileName . '"');
}
return $this->createForNamespace($namespace, $contents);
}
return new Context($namespace, []);
}
/**
* Build a Context for a namespace in the provided file contents.
*
* @see Context for more information on Contexts.
*
* @param string $namespace It does not matter if a `\` precedes the namespace name,
* this method first normalizes.
* @param string $fileContents The file's contents to retrieve the aliases from with the given namespace.
*/
public function createForNamespace(string $namespace, string $fileContents) : Context
{
$namespace = trim($namespace, '\\');
$useStatements = [];
$currentNamespace = '';
$tokens = new ArrayIterator(token_get_all($fileContents));
while ($tokens->valid()) {
$currentToken = $tokens->current();
switch ($currentToken[0]) {
case T_NAMESPACE:
$currentNamespace = $this->parseNamespace($tokens);
break;
case T_CLASS:
// Fast-forward the iterator through the class so that any
// T_USE tokens found within are skipped - these are not
// valid namespace use statements so should be ignored.
$braceLevel = 0;
$firstBraceFound = false;
while ($tokens->valid() && ($braceLevel > 0 || !$firstBraceFound)) {
$currentToken = $tokens->current();
if ($currentToken === '{'
|| in_array($currentToken[0], [T_CURLY_OPEN, T_DOLLAR_OPEN_CURLY_BRACES], true)) {
if (!$firstBraceFound) {
$firstBraceFound = true;
}
++$braceLevel;
}
if ($currentToken === '}') {
--$braceLevel;
}
$tokens->next();
}
break;
case T_USE:
if ($currentNamespace === $namespace) {
$useStatements += $this->parseUseStatement($tokens);
}
break;
}
$tokens->next();
}
return new Context($namespace, $useStatements);
}
/**
* Deduce the name from tokens when we are at the T_NAMESPACE token.
*
* @param ArrayIterator $tokens
*/
private function parseNamespace(ArrayIterator $tokens) : string
{
// skip to the first string or namespace separator
$this->skipToNextStringOrNamespaceSeparator($tokens);
$name = '';
$acceptedTokens = [T_STRING, T_NS_SEPARATOR, T_NAME_QUALIFIED];
while ($tokens->valid() && in_array($tokens->current()[0], $acceptedTokens, true)) {
$name .= $tokens->current()[1];
$tokens->next();
}
return $name;
}
/**
* Deduce the names of all imports when we are at the T_USE token.
*
* @param ArrayIterator $tokens
*
* @return string[]
*
* @psalm-return array
*/
private function parseUseStatement(ArrayIterator $tokens) : array
{
$uses = [];
while ($tokens->valid()) {
$this->skipToNextStringOrNamespaceSeparator($tokens);
$uses += $this->extractUseStatements($tokens);
$currentToken = $tokens->current();
if ($currentToken[0] === self::T_LITERAL_END_OF_USE) {
return $uses;
}
}
return $uses;
}
/**
* Fast-forwards the iterator as longs as we don't encounter a T_STRING or T_NS_SEPARATOR token.
*
* @param ArrayIterator $tokens
*/
private function skipToNextStringOrNamespaceSeparator(ArrayIterator $tokens) : void
{
while ($tokens->valid()) {
$currentToken = $tokens->current();
if (in_array($currentToken[0], [T_STRING, T_NS_SEPARATOR], true)) {
break;
}
if ($currentToken[0] === T_NAME_QUALIFIED) {
break;
}
if (defined('T_NAME_FULLY_QUALIFIED') && $currentToken[0] === T_NAME_FULLY_QUALIFIED) {
break;
}
$tokens->next();
}
}
/**
* Deduce the namespace name and alias of an import when we are at the T_USE token or have not reached the end of
* a USE statement yet. This will return a key/value array of the alias => namespace.
*
* @param ArrayIterator $tokens
*
* @return string[]
*
* @psalm-suppress TypeDoesNotContainType
*
* @psalm-return array
*/
private function extractUseStatements(ArrayIterator $tokens) : array
{
$extractedUseStatements = [];
$groupedNs = '';
$currentNs = '';
$currentAlias = '';
$state = 'start';
while ($tokens->valid()) {
$currentToken = $tokens->current();
$tokenId = is_string($currentToken) ? $currentToken : $currentToken[0];
$tokenValue = is_string($currentToken) ? null : $currentToken[1];
switch ($state) {
case 'start':
switch ($tokenId) {
case T_STRING:
case T_NS_SEPARATOR:
$currentNs .= (string) $tokenValue;
$currentAlias = $tokenValue;
break;
case T_NAME_QUALIFIED:
case T_NAME_FULLY_QUALIFIED:
$currentNs .= (string) $tokenValue;
$currentAlias = substr(
(string) $tokenValue,
(int) (strrpos((string) $tokenValue, '\\')) + 1
);
break;
case T_CURLY_OPEN:
case '{':
$state = 'grouped';
$groupedNs = $currentNs;
break;
case T_AS:
$state = 'start-alias';
break;
case self::T_LITERAL_USE_SEPARATOR:
case self::T_LITERAL_END_OF_USE:
$state = 'end';
break;
default:
break;
}
break;
case 'start-alias':
switch ($tokenId) {
case T_STRING:
$currentAlias = $tokenValue;
break;
case self::T_LITERAL_USE_SEPARATOR:
case self::T_LITERAL_END_OF_USE:
$state = 'end';
break;
default:
break;
}
break;
case 'grouped':
switch ($tokenId) {
case T_STRING:
case T_NS_SEPARATOR:
$currentNs .= (string) $tokenValue;
$currentAlias = $tokenValue;
break;
case T_AS:
$state = 'grouped-alias';
break;
case self::T_LITERAL_USE_SEPARATOR:
$state = 'grouped';
$extractedUseStatements[(string) $currentAlias] = $currentNs;
$currentNs = $groupedNs;
$currentAlias = '';
break;
case self::T_LITERAL_END_OF_USE:
$state = 'end';
break;
default:
break;
}
break;
case 'grouped-alias':
switch ($tokenId) {
case T_STRING:
$currentAlias = $tokenValue;
break;
case self::T_LITERAL_USE_SEPARATOR:
$state = 'grouped';
$extractedUseStatements[(string) $currentAlias] = $currentNs;
$currentNs = $groupedNs;
$currentAlias = '';
break;
case self::T_LITERAL_END_OF_USE:
$state = 'end';
break;
default:
break;
}
}
if ($state === 'end') {
break;
}
$tokens->next();
}
if ($groupedNs !== $currentNs) {
$extractedUseStatements[(string) $currentAlias] = $currentNs;
}
return $extractedUseStatements;
}
}
PK ! ٬ ! type-resolver/src/Types/Self_.phpnu Iw fqsen = $fqsen;
}
/**
* Returns the FQSEN associated with this object.
*/
public function getFqsen() : ?Fqsen
{
return $this->fqsen;
}
/**
* Returns a rendered output of the Type as it would be used in a DocBlock.
*/
public function __toString() : string
{
if ($this->fqsen === null) {
return 'class-string';
}
return 'class-string<' . (string) $this->fqsen . '>';
}
}
PK ! r r " type-resolver/src/Types/Mixed_.phpnu Iw @ # type-resolver/src/Types/Context.phpnu Iw Fully Qualified Namespace.
* @psalm-var array
*/
private $namespaceAliases;
/**
* Initializes the new context and normalizes all passed namespaces to be in Qualified Namespace Name (QNN)
* format (without a preceding `\`).
*
* @param string $namespace The namespace where this DocBlock resides in.
* @param string[] $namespaceAliases List of namespace aliases => Fully Qualified Namespace.
*
* @psalm-param array $namespaceAliases
*/
public function __construct(string $namespace, array $namespaceAliases = [])
{
$this->namespace = $namespace !== 'global' && $namespace !== 'default'
? trim($namespace, '\\')
: '';
foreach ($namespaceAliases as $alias => $fqnn) {
if ($fqnn[0] === '\\') {
$fqnn = substr($fqnn, 1);
}
if ($fqnn[strlen($fqnn) - 1] === '\\') {
$fqnn = substr($fqnn, 0, -1);
}
$namespaceAliases[$alias] = $fqnn;
}
$this->namespaceAliases = $namespaceAliases;
}
/**
* Returns the Qualified Namespace Name (thus without `\` in front) where the associated element is in.
*/
public function getNamespace() : string
{
return $this->namespace;
}
/**
* Returns a list of Qualified Namespace Names (thus without `\` in front) that are imported, the keys represent
* the alias for the imported Namespace.
*
* @return string[]
*
* @psalm-return array
*/
public function getNamespaceAliases() : array
{
return $this->namespaceAliases;
}
}
PK ! "B1eG G $ type-resolver/src/Types/Nullable.phpnu Iw realType = $realType;
}
/**
* Provide access to the actual type directly, if needed.
*/
public function getActualType() : Type
{
return $this->realType;
}
/**
* Returns a rendered output of the Type as it would be used in a DocBlock.
*/
public function __toString() : string
{
return '?' . $this->realType->__toString();
}
}
PK ! 9q q % type-resolver/src/Types/Resource_.phpnu Iw keyType) {
return 'iterable<' . $this->keyType . ',' . $this->valueType . '>';
}
if ($this->valueType instanceof Mixed_) {
return 'iterable';
}
return 'iterable<' . $this->valueType . '>';
}
}
PK ! F ! type-resolver/src/Types/Void_.phpnu Iw List of recognized keywords and unto which Value Object they map
* @psalm-var array>
*/
private $keywords = [
'string' => Types\String_::class,
'class-string' => Types\ClassString::class,
'int' => Types\Integer::class,
'integer' => Types\Integer::class,
'bool' => Types\Boolean::class,
'boolean' => Types\Boolean::class,
'real' => Types\Float_::class,
'float' => Types\Float_::class,
'double' => Types\Float_::class,
'object' => Object_::class,
'mixed' => Types\Mixed_::class,
'array' => Array_::class,
'resource' => Types\Resource_::class,
'void' => Types\Void_::class,
'null' => Types\Null_::class,
'scalar' => Types\Scalar::class,
'callback' => Types\Callable_::class,
'callable' => Types\Callable_::class,
'false' => PseudoTypes\False_::class,
'true' => PseudoTypes\True_::class,
'self' => Types\Self_::class,
'$this' => Types\This::class,
'static' => Types\Static_::class,
'parent' => Types\Parent_::class,
'iterable' => Iterable_::class,
];
/**
* @var FqsenResolver
* @psalm-readonly
*/
private $fqsenResolver;
/**
* Initializes this TypeResolver with the means to create and resolve Fqsen objects.
*/
public function __construct(?FqsenResolver $fqsenResolver = null)
{
$this->fqsenResolver = $fqsenResolver ?: new FqsenResolver();
}
/**
* Analyzes the given type and returns the FQCN variant.
*
* When a type is provided this method checks whether it is not a keyword or
* Fully Qualified Class Name. If so it will use the given namespace and
* aliases to expand the type to a FQCN representation.
*
* This method only works as expected if the namespace and aliases are set;
* no dynamic reflection is being performed here.
*
* @uses Context::getNamespaceAliases() to check whether the first part of the relative type name should not be
* replaced with another namespace.
* @uses Context::getNamespace() to determine with what to prefix the type name.
*
* @param string $type The relative or absolute type.
*/
public function resolve(string $type, ?Context $context = null) : Type
{
$type = trim($type);
if (!$type) {
throw new InvalidArgumentException('Attempted to resolve "' . $type . '" but it appears to be empty');
}
if ($context === null) {
$context = new Context('');
}
// split the type string into tokens `|`, `?`, `<`, `>`, `,`, `(`, `)`, `[]`, '<', '>' and type names
$tokens = preg_split(
'/(\\||\\?|<|>|&|, ?|\\(|\\)|\\[\\]+)/',
$type,
-1,
PREG_SPLIT_NO_EMPTY | PREG_SPLIT_DELIM_CAPTURE
);
if ($tokens === false) {
throw new InvalidArgumentException('Unable to split the type string "' . $type . '" into tokens');
}
/** @var ArrayIterator $tokenIterator */
$tokenIterator = new ArrayIterator($tokens);
return $this->parseTypes($tokenIterator, $context, self::PARSER_IN_COMPOUND);
}
/**
* Analyse each tokens and creates types
*
* @param ArrayIterator $tokens the iterator on tokens
* @param int $parserContext on of self::PARSER_* constants, indicating
* the context where we are in the parsing
*/
private function parseTypes(ArrayIterator $tokens, Context $context, int $parserContext) : Type
{
$types = [];
$token = '';
$compoundToken = '|';
while ($tokens->valid()) {
$token = $tokens->current();
if ($token === null) {
throw new RuntimeException(
'Unexpected nullable character'
);
}
if ($token === '|' || $token === '&') {
if (count($types) === 0) {
throw new RuntimeException(
'A type is missing before a type separator'
);
}
if (!in_array($parserContext, [
self::PARSER_IN_COMPOUND,
self::PARSER_IN_ARRAY_EXPRESSION,
self::PARSER_IN_COLLECTION_EXPRESSION,
], true)
) {
throw new RuntimeException(
'Unexpected type separator'
);
}
$compoundToken = $token;
$tokens->next();
} elseif ($token === '?') {
if (!in_array($parserContext, [
self::PARSER_IN_COMPOUND,
self::PARSER_IN_ARRAY_EXPRESSION,
self::PARSER_IN_COLLECTION_EXPRESSION,
], true)
) {
throw new RuntimeException(
'Unexpected nullable character'
);
}
$tokens->next();
$type = $this->parseTypes($tokens, $context, self::PARSER_IN_NULLABLE);
$types[] = new Nullable($type);
} elseif ($token === '(') {
$tokens->next();
$type = $this->parseTypes($tokens, $context, self::PARSER_IN_ARRAY_EXPRESSION);
$token = $tokens->current();
if ($token === null) { // Someone did not properly close their array expression ..
break;
}
$tokens->next();
$resolvedType = new Expression($type);
$types[] = $resolvedType;
} elseif ($parserContext === self::PARSER_IN_ARRAY_EXPRESSION && $token[0] === ')') {
break;
} elseif ($token === '<') {
if (count($types) === 0) {
throw new RuntimeException(
'Unexpected collection operator "<", class name is missing'
);
}
$classType = array_pop($types);
if ($classType !== null) {
if ((string) $classType === 'class-string') {
$types[] = $this->resolveClassString($tokens, $context);
} else {
$types[] = $this->resolveCollection($tokens, $classType, $context);
}
}
$tokens->next();
} elseif ($parserContext === self::PARSER_IN_COLLECTION_EXPRESSION
&& ($token === '>' || trim($token) === ',')
) {
break;
} elseif ($token === self::OPERATOR_ARRAY) {
end($types);
$last = key($types);
$lastItem = $types[$last];
if ($lastItem instanceof Expression) {
$lastItem = $lastItem->getValueType();
}
$types[$last] = new Array_($lastItem);
$tokens->next();
} else {
$type = $this->resolveSingleType($token, $context);
$tokens->next();
if ($parserContext === self::PARSER_IN_NULLABLE) {
return $type;
}
$types[] = $type;
}
}
if ($token === '|' || $token === '&') {
throw new RuntimeException(
'A type is missing after a type separator'
);
}
if (count($types) === 0) {
if ($parserContext === self::PARSER_IN_NULLABLE) {
throw new RuntimeException(
'A type is missing after a nullable character'
);
}
if ($parserContext === self::PARSER_IN_ARRAY_EXPRESSION) {
throw new RuntimeException(
'A type is missing in an array expression'
);
}
if ($parserContext === self::PARSER_IN_COLLECTION_EXPRESSION) {
throw new RuntimeException(
'A type is missing in a collection expression'
);
}
} elseif (count($types) === 1) {
return $types[0];
}
if ($compoundToken === '|') {
return new Compound(array_values($types));
}
return new Intersection(array_values($types));
}
/**
* resolve the given type into a type object
*
* @param string $type the type string, representing a single type
*
* @return Type|Array_|Object_
*
* @psalm-mutation-free
*/
private function resolveSingleType(string $type, Context $context) : object
{
switch (true) {
case $this->isKeyword($type):
return $this->resolveKeyword($type);
case $this->isFqsen($type):
return $this->resolveTypedObject($type);
case $this->isPartialStructuralElementName($type):
return $this->resolveTypedObject($type, $context);
// @codeCoverageIgnoreStart
default:
// I haven't got the foggiest how the logic would come here but added this as a defense.
throw new RuntimeException(
'Unable to resolve type "' . $type . '", there is no known method to resolve it'
);
}
// @codeCoverageIgnoreEnd
}
/**
* Adds a keyword to the list of Keywords and associates it with a specific Value Object.
*
* @psalm-param class-string $typeClassName
*/
public function addKeyword(string $keyword, string $typeClassName) : void
{
if (!class_exists($typeClassName)) {
throw new InvalidArgumentException(
'The Value Object that needs to be created with a keyword "' . $keyword . '" must be an existing class'
. ' but we could not find the class ' . $typeClassName
);
}
if (!in_array(Type::class, class_implements($typeClassName), true)) {
throw new InvalidArgumentException(
'The class "' . $typeClassName . '" must implement the interface "phpDocumentor\Reflection\Type"'
);
}
$this->keywords[$keyword] = $typeClassName;
}
/**
* Detects whether the given type represents a PHPDoc keyword.
*
* @param string $type A relative or absolute type as defined in the phpDocumentor documentation.
*
* @psalm-mutation-free
*/
private function isKeyword(string $type) : bool
{
return array_key_exists(strtolower($type), $this->keywords);
}
/**
* Detects whether the given type represents a relative structural element name.
*
* @param string $type A relative or absolute type as defined in the phpDocumentor documentation.
*
* @psalm-mutation-free
*/
private function isPartialStructuralElementName(string $type) : bool
{
return ($type[0] !== self::OPERATOR_NAMESPACE) && !$this->isKeyword($type);
}
/**
* Tests whether the given type is a Fully Qualified Structural Element Name.
*
* @psalm-mutation-free
*/
private function isFqsen(string $type) : bool
{
return strpos($type, self::OPERATOR_NAMESPACE) === 0;
}
/**
* Resolves the given keyword (such as `string`) into a Type object representing that keyword.
*
* @psalm-mutation-free
*/
private function resolveKeyword(string $type) : Type
{
$className = $this->keywords[strtolower($type)];
return new $className();
}
/**
* Resolves the given FQSEN string into an FQSEN object.
*
* @psalm-mutation-free
*/
private function resolveTypedObject(string $type, ?Context $context = null) : Object_
{
return new Object_($this->fqsenResolver->resolve($type, $context));
}
/**
* Resolves class string
*
* @param ArrayIterator $tokens
*/
private function resolveClassString(ArrayIterator $tokens, Context $context) : Type
{
$tokens->next();
$classType = $this->parseTypes($tokens, $context, self::PARSER_IN_COLLECTION_EXPRESSION);
if (!$classType instanceof Object_ || $classType->getFqsen() === null) {
throw new RuntimeException(
$classType . ' is not a class string'
);
}
$token = $tokens->current();
if ($token !== '>') {
if (empty($token)) {
throw new RuntimeException(
'class-string: ">" is missing'
);
}
throw new RuntimeException(
'Unexpected character "' . $token . '", ">" is missing'
);
}
return new ClassString($classType->getFqsen());
}
/**
* Resolves the collection values and keys
*
* @param ArrayIterator $tokens
*
* @return Array_|Iterable_|Collection
*/
private function resolveCollection(ArrayIterator $tokens, Type $classType, Context $context) : Type
{
$isArray = ((string) $classType === 'array');
$isIterable = ((string) $classType === 'iterable');
// allow only "array", "iterable" or class name before "<"
if (!$isArray && !$isIterable
&& (!$classType instanceof Object_ || $classType->getFqsen() === null)) {
throw new RuntimeException(
$classType . ' is not a collection'
);
}
$tokens->next();
$valueType = $this->parseTypes($tokens, $context, self::PARSER_IN_COLLECTION_EXPRESSION);
$keyType = null;
$token = $tokens->current();
if ($token !== null && trim($token) === ',') {
// if we have a comma, then we just parsed the key type, not the value type
$keyType = $valueType;
if ($isArray) {
// check the key type for an "array" collection. We allow only
// strings or integers.
if (!$keyType instanceof String_ &&
!$keyType instanceof Integer &&
!$keyType instanceof Compound
) {
throw new RuntimeException(
'An array can have only integers or strings as keys'
);
}
if ($keyType instanceof Compound) {
foreach ($keyType->getIterator() as $item) {
if (!$item instanceof String_ &&
!$item instanceof Integer
) {
throw new RuntimeException(
'An array can have only integers or strings as keys'
);
}
}
}
}
$tokens->next();
// now let's parse the value type
$valueType = $this->parseTypes($tokens, $context, self::PARSER_IN_COLLECTION_EXPRESSION);
}
$token = $tokens->current();
if ($token !== '>') {
if (empty($token)) {
throw new RuntimeException(
'Collection: ">" is missing'
);
}
throw new RuntimeException(
'Unexpected character "' . $token . '", ">" is missing'
);
}
if ($isArray) {
return new Array_($valueType, $keyType);
}
if ($isIterable) {
return new Iterable_($valueType, $keyType);
}
if ($classType instanceof Object_) {
return $this->makeCollectionFromObject($classType, $valueType, $keyType);
}
throw new RuntimeException('Invalid $classType provided');
}
/**
* @psalm-pure
*/
private function makeCollectionFromObject(Object_ $object, Type $valueType, ?Type $keyType = null) : Collection
{
return new Collection($object->getFqsen(), $valueType, $keyType);
}
}
PK ! G6x # type-resolver/src/FqsenResolver.phpnu Iw isFqsen($fqsen)) {
return new Fqsen($fqsen);
}
return $this->resolvePartialStructuralElementName($fqsen, $context);
}
/**
* Tests whether the given type is a Fully Qualified Structural Element Name.
*/
private function isFqsen(string $type) : bool
{
return strpos($type, self::OPERATOR_NAMESPACE) === 0;
}
/**
* Resolves a partial Structural Element Name (i.e. `Reflection\DocBlock`) to its FQSEN representation
* (i.e. `\phpDocumentor\Reflection\DocBlock`) based on the Namespace and aliases mentioned in the Context.
*
* @throws InvalidArgumentException When type is not a valid FQSEN.
*/
private function resolvePartialStructuralElementName(string $type, Context $context) : Fqsen
{
$typeParts = explode(self::OPERATOR_NAMESPACE, $type, 2);
$namespaceAliases = $context->getNamespaceAliases();
// if the first segment is not an alias; prepend namespace name and return
if (!isset($namespaceAliases[$typeParts[0]])) {
$namespace = $context->getNamespace();
if ($namespace !== '') {
$namespace .= self::OPERATOR_NAMESPACE;
}
return new Fqsen(self::OPERATOR_NAMESPACE . $namespace . $type);
}
$typeParts[0] = $namespaceAliases[$typeParts[0]];
return new Fqsen(self::OPERATOR_NAMESPACE . implode(self::OPERATOR_NAMESPACE, $typeParts));
}
}
PK ! "WAs s ( type-resolver/src/PseudoTypes/False_.phpnu Iw fqsen = $fqsen;
if (isset($matches[2])) {
$this->name = $matches[2];
} else {
$matches = explode('\\', $fqsen);
$name = end($matches);
assert(is_string($name));
$this->name = trim($name, '()');
}
}
/**
* converts this class to string.
*/
public function __toString() : string
{
return $this->fqsen;
}
/**
* Returns the name of the element without path.
*/
public function getName() : string
{
return $this->name;
}
}
PK ! 2X X ( reflection-common/src/ProjectFactory.phpnu Iw lineNumber = $lineNumber;
$this->columnNumber = $columnNumber;
}
/**
* Returns the line number that is covered by this location.
*/
public function getLineNumber() : int
{
return $this->lineNumber;
}
/**
* Returns the column number (character position on a line) for this location object.
*/
public function getColumnNumber() : int
{
return $this->columnNumber;
}
}
PK ! 079 ! reflection-common/src/Project.phpnu Iw create($docComment);
```
The `create` method will yield an object of type `\phpDocumentor\Reflection\DocBlock`
whose methods can be queried:
```php
// Contains the summary for this DocBlock
$summary = $docblock->getSummary();
// Contains \phpDocumentor\Reflection\DocBlock\Description object
$description = $docblock->getDescription();
// You can either cast it to string
$description = (string) $docblock->getDescription();
// Or use the render method to get a string representation of the Description.
$description = $docblock->getDescription()->render();
```
> For more examples it would be best to review the scripts in the [`/examples` folder](/examples).
PK ! 8 8 reflection-docblock/LICENSEnu Iw The MIT License (MIT)
Copyright (c) 2010 Mike van Riel
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.
PK ! LAw< < ! reflection-docblock/composer.jsonnu Iw {
"name": "phpdocumentor/reflection-docblock",
"description": "With this component, a library can provide support for annotations via DocBlocks or otherwise retrieve information that is embedded in a DocBlock.",
"type": "library",
"license": "MIT",
"authors": [
{
"name": "Mike van Riel",
"email": "me@mikevanriel.com"
},
{
"name": "Jaap van Otterdijk",
"email": "account@ijaap.nl"
}
],
"require": {
"php": "^7.2 || ^8.0",
"phpdocumentor/type-resolver": "^1.3",
"webmozart/assert": "^1.9.1",
"phpdocumentor/reflection-common": "^2.2",
"ext-filter": "*"
},
"require-dev": {
"mockery/mockery": "~1.3.2"
},
"autoload": {
"psr-4": {
"phpDocumentor\\Reflection\\": "src"
}
},
"autoload-dev": {
"psr-4": {
"phpDocumentor\\Reflection\\": "tests/unit"
}
},
"extra": {
"branch-alias": {
"dev-master": "5.x-dev"
}
}
}
PK ! /qH{ { $ reflection-docblock/src/DocBlock.phpnu Iw summary = $summary;
$this->description = $description ?: new DocBlock\Description('');
foreach ($tags as $tag) {
$this->addTag($tag);
}
$this->context = $context;
$this->location = $location;
$this->isTemplateEnd = $isTemplateEnd;
$this->isTemplateStart = $isTemplateStart;
}
public function getSummary() : string
{
return $this->summary;
}
public function getDescription() : DocBlock\Description
{
return $this->description;
}
/**
* Returns the current context.
*/
public function getContext() : ?Types\Context
{
return $this->context;
}
/**
* Returns the current location.
*/
public function getLocation() : ?Location
{
return $this->location;
}
/**
* Returns whether this DocBlock is the start of a Template section.
*
* A Docblock may serve as template for a series of subsequent DocBlocks. This is indicated by a special marker
* (`#@+`) that is appended directly after the opening `/**` of a DocBlock.
*
* An example of such an opening is:
*
* ```
* /**#@+
* * My DocBlock
* * /
* ```
*
* The description and tags (not the summary!) are copied onto all subsequent DocBlocks and also applied to all
* elements that follow until another DocBlock is found that contains the closing marker (`#@-`).
*
* @see self::isTemplateEnd() for the check whether a closing marker was provided.
*/
public function isTemplateStart() : bool
{
return $this->isTemplateStart;
}
/**
* Returns whether this DocBlock is the end of a Template section.
*
* @see self::isTemplateStart() for a more complete description of the Docblock Template functionality.
*/
public function isTemplateEnd() : bool
{
return $this->isTemplateEnd;
}
/**
* Returns the tags for this DocBlock.
*
* @return Tag[]
*/
public function getTags() : array
{
return $this->tags;
}
/**
* Returns an array of tags matching the given name. If no tags are found
* an empty array is returned.
*
* @param string $name String to search by.
*
* @return Tag[]
*/
public function getTagsByName(string $name) : array
{
$result = [];
foreach ($this->getTags() as $tag) {
if ($tag->getName() !== $name) {
continue;
}
$result[] = $tag;
}
return $result;
}
/**
* Checks if a tag of a certain type is present in this DocBlock.
*
* @param string $name Tag name to check for.
*/
public function hasTag(string $name) : bool
{
foreach ($this->getTags() as $tag) {
if ($tag->getName() === $name) {
return true;
}
}
return false;
}
/**
* Remove a tag from this DocBlock.
*
* @param Tag $tagToRemove The tag to remove.
*/
public function removeTag(Tag $tagToRemove) : void
{
foreach ($this->tags as $key => $tag) {
if ($tag === $tagToRemove) {
unset($this->tags[$key]);
break;
}
}
}
/**
* Adds a tag to this DocBlock.
*
* @param Tag $tag The tag to add.
*/
private function addTag(Tag $tag) : void
{
$this->tags[] = $tag;
}
}
PK ! g2 2 ! reflection-docblock/src/Utils.phpnu Iw version = $version;
$this->description = $description;
}
public static function create(
?string $body,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : ?self {
if (empty($body)) {
return new static();
}
$matches = [];
if (!preg_match('/^(' . self::REGEX_VECTOR . ')\s*(.+)?$/sux', $body, $matches)) {
return null;
}
$description = null;
if ($descriptionFactory !== null) {
$description = $descriptionFactory->create($matches[2] ?? '', $context);
}
return new static(
$matches[1],
$description
);
}
/**
* Gets the version section of the tag.
*/
public function getVersion() : ?string
{
return $this->version;
}
/**
* Returns a string representation for this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$version = (string) $this->version;
return $version . ($description !== '' ? ($version !== '' ? ' ' : '') . $description : '');
}
}
PK ! e؋{ { 1 reflection-docblock/src/DocBlock/Tags/BaseTag.phpnu Iw name;
}
public function getDescription() : ?Description
{
return $this->description;
}
public function render(?Formatter $formatter = null) : string
{
if ($formatter === null) {
$formatter = new Formatter\PassthroughFormatter();
}
return $formatter->format($this);
}
}
PK ! 8 2 reflection-docblock/src/DocBlock/Tags/Property.phpnu Iw name = 'property';
$this->variableName = $variableName;
$this->type = $type;
$this->description = $description;
}
public static function create(
string $body,
?TypeResolver $typeResolver = null,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::stringNotEmpty($body);
Assert::notNull($typeResolver);
Assert::notNull($descriptionFactory);
[$firstPart, $body] = self::extractTypeFromBody($body);
$type = null;
$parts = Utils::pregSplit('/(\s+)/Su', $body, 2, PREG_SPLIT_DELIM_CAPTURE);
$variableName = '';
// if the first item that is encountered is not a variable; it is a type
if ($firstPart && $firstPart[0] !== '$') {
$type = $typeResolver->resolve($firstPart, $context);
} else {
// first part is not a type; we should prepend it to the parts array for further processing
array_unshift($parts, $firstPart);
}
// if the next item starts with a $ it must be the variable name
if (isset($parts[0]) && strpos($parts[0], '$') === 0) {
$variableName = array_shift($parts);
if ($type) {
array_shift($parts);
}
Assert::notNull($variableName);
$variableName = substr($variableName, 1);
}
$description = $descriptionFactory->create(implode('', $parts), $context);
return new static($variableName, $type, $description);
}
/**
* Returns the variable's name.
*/
public function getVariableName() : ?string
{
return $this->variableName;
}
/**
* Returns a string representation for this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
if ($this->variableName) {
$variableName = '$' . $this->variableName;
} else {
$variableName = '';
}
$type = (string) $this->type;
return $type
. ($variableName !== '' ? ($type !== '' ? ' ' : '') . $variableName : '')
. ($description !== '' ? ($type !== '' || $variableName !== '' ? ' ' : '') . $description : '');
}
}
PK ! t . reflection-docblock/src/DocBlock/Tags/Link.phpnu Iw link = $link;
$this->description = $description;
}
public static function create(
string $body,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::notNull($descriptionFactory);
$parts = Utils::pregSplit('/\s+/Su', $body, 2);
$description = isset($parts[1]) ? $descriptionFactory->create($parts[1], $context) : null;
return new static($parts[0], $description);
}
/**
* Gets the link
*/
public function getLink() : string
{
return $this->link;
}
/**
* Returns a string representation for this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$link = (string) $this->link;
return $link . ($description !== '' ? ($link !== '' ? ' ' : '') . $description : '');
}
}
PK ! ."- - 1 reflection-docblock/src/DocBlock/Tags/Return_.phpnu Iw name = 'return';
$this->type = $type;
$this->description = $description;
}
public static function create(
string $body,
?TypeResolver $typeResolver = null,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::notNull($typeResolver);
Assert::notNull($descriptionFactory);
[$type, $description] = self::extractTypeFromBody($body);
$type = $typeResolver->resolve($type, $context);
$description = $descriptionFactory->create($description, $context);
return new static($type, $description);
}
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$type = $this->type ? '' . $this->type : 'mixed';
return $type . ($description !== '' ? ($type !== '' ? ' ' : '') . $description : '');
}
}
PK ! J\ \ 0 reflection-docblock/src/DocBlock/Tags/Method.phpnu Iw
* @var array>
*/
private $arguments;
/** @var bool */
private $isStatic;
/** @var Type */
private $returnType;
/**
* @param array> $arguments
*
* @phpstan-param array $arguments
*/
public function __construct(
string $methodName,
array $arguments = [],
?Type $returnType = null,
bool $static = false,
?Description $description = null
) {
Assert::stringNotEmpty($methodName);
if ($returnType === null) {
$returnType = new Void_();
}
$this->methodName = $methodName;
$this->arguments = $this->filterArguments($arguments);
$this->returnType = $returnType;
$this->isStatic = $static;
$this->description = $description;
}
public static function create(
string $body,
?TypeResolver $typeResolver = null,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : ?self {
Assert::stringNotEmpty($body);
Assert::notNull($typeResolver);
Assert::notNull($descriptionFactory);
// 1. none or more whitespace
// 2. optionally the keyword "static" followed by whitespace
// 3. optionally a word with underscores followed by whitespace : as
// type for the return value
// 4. then optionally a word with underscores followed by () and
// whitespace : as method name as used by phpDocumentor
// 5. then a word with underscores, followed by ( and any character
// until a ) and whitespace : as method name with signature
// 6. any remaining text : as description
if (!preg_match(
'/^
# Static keyword
# Declares a static method ONLY if type is also present
(?:
(static)
\s+
)?
# Return type
(?:
(
(?:[\w\|_\\\\]*\$this[\w\|_\\\\]*)
|
(?:
(?:[\w\|_\\\\]+)
# array notation
(?:\[\])*
)*+
)
\s+
)?
# Method name
([\w_]+)
# Arguments
(?:
\(([^\)]*)\)
)?
\s*
# Description
(.*)
$/sux',
$body,
$matches
)) {
return null;
}
[, $static, $returnType, $methodName, $argumentLines, $description] = $matches;
$static = $static === 'static';
if ($returnType === '') {
$returnType = 'void';
}
$returnType = $typeResolver->resolve($returnType, $context);
$description = $descriptionFactory->create($description, $context);
/** @phpstan-var array $arguments */
$arguments = [];
if ($argumentLines !== '') {
$argumentsExploded = explode(',', $argumentLines);
foreach ($argumentsExploded as $argument) {
$argument = explode(' ', self::stripRestArg(trim($argument)), 2);
if (strpos($argument[0], '$') === 0) {
$argumentName = substr($argument[0], 1);
$argumentType = new Mixed_();
} else {
$argumentType = $typeResolver->resolve($argument[0], $context);
$argumentName = '';
if (isset($argument[1])) {
$argument[1] = self::stripRestArg($argument[1]);
$argumentName = substr($argument[1], 1);
}
}
$arguments[] = ['name' => $argumentName, 'type' => $argumentType];
}
}
return new static($methodName, $arguments, $returnType, $static, $description);
}
/**
* Retrieves the method name.
*/
public function getMethodName() : string
{
return $this->methodName;
}
/**
* @return array>
*
* @phpstan-return array
*/
public function getArguments() : array
{
return $this->arguments;
}
/**
* Checks whether the method tag describes a static method or not.
*
* @return bool TRUE if the method declaration is for a static method, FALSE otherwise.
*/
public function isStatic() : bool
{
return $this->isStatic;
}
public function getReturnType() : Type
{
return $this->returnType;
}
public function __toString() : string
{
$arguments = [];
foreach ($this->arguments as $argument) {
$arguments[] = $argument['type'] . ' $' . $argument['name'];
}
$argumentStr = '(' . implode(', ', $arguments) . ')';
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$static = $this->isStatic ? 'static' : '';
$returnType = (string) $this->returnType;
$methodName = (string) $this->methodName;
return $static
. ($returnType !== '' ? ($static !== '' ? ' ' : '') . $returnType : '')
. ($methodName !== '' ? ($static !== '' || $returnType !== '' ? ' ' : '') . $methodName : '')
. $argumentStr
. ($description !== '' ? ' ' . $description : '');
}
/**
* @param mixed[][]|string[] $arguments
*
* @return mixed[][]
*
* @phpstan-param array $arguments
* @phpstan-return array
*/
private function filterArguments(array $arguments = []) : array
{
$result = [];
foreach ($arguments as $argument) {
if (is_string($argument)) {
$argument = ['name' => $argument];
}
if (!isset($argument['type'])) {
$argument['type'] = new Mixed_();
}
$keys = array_keys($argument);
sort($keys);
if ($keys !== ['name', 'type']) {
throw new InvalidArgumentException(
'Arguments can only have the "name" and "type" fields, found: ' . var_export($keys, true)
);
}
$result[] = $argument;
}
return $result;
}
private static function stripRestArg(string $argument) : string
{
if (strpos($argument, '...') === 0) {
$argument = trim(substr($argument, 3));
}
return $argument;
}
}
PK ! ះ 4 reflection-docblock/src/DocBlock/Tags/InvalidTag.phpnu Iw name = $name;
$this->body = $body;
}
public function getException() : ?Throwable
{
return $this->throwable;
}
public function getName() : string
{
return $this->name;
}
public static function create(string $body, string $name = '') : self
{
return new self($name, $body);
}
public function withError(Throwable $exception) : self
{
$this->flattenExceptionBacktrace($exception);
$tag = new self($this->name, $this->body);
$tag->throwable = $exception;
return $tag;
}
/**
* Removes all complex types from backtrace
*
* Not all objects are serializable. So we need to remove them from the
* stored exception to be sure that we do not break existing library usage.
*/
private function flattenExceptionBacktrace(Throwable $exception) : void
{
$traceProperty = (new ReflectionClass(Exception::class))->getProperty('trace');
$traceProperty->setAccessible(true);
do {
$trace = $exception->getTrace();
if (isset($trace[0]['args'])) {
$trace = array_map(
function (array $call) : array {
$call['args'] = array_map([$this, 'flattenArguments'], $call['args']);
return $call;
},
$trace
);
}
$traceProperty->setValue($exception, $trace);
$exception = $exception->getPrevious();
} while ($exception !== null);
$traceProperty->setAccessible(false);
}
/**
* @param mixed $value
*
* @return mixed
*
* @throws ReflectionException
*/
private function flattenArguments($value)
{
if ($value instanceof Closure) {
$closureReflection = new ReflectionFunction($value);
$value = sprintf(
'(Closure at %s:%s)',
$closureReflection->getFileName(),
$closureReflection->getStartLine()
);
} elseif (is_object($value)) {
$value = sprintf('object(%s)', get_class($value));
} elseif (is_resource($value)) {
$value = sprintf('resource(%s)', get_resource_type($value));
} elseif (is_array($value)) {
$value = array_map([$this, 'flattenArguments'], $value);
}
return $value;
}
public function render(?Formatter $formatter = null) : string
{
if ($formatter === null) {
$formatter = new Formatter\PassthroughFormatter();
}
return $formatter->format($this);
}
public function __toString() : string
{
return $this->body;
}
}
PK ! 7 reflection-docblock/src/DocBlock/Tags/Reference/Url.phpnu Iw uri = $uri;
}
public function __toString() : string
{
return $this->uri;
}
}
PK !
v 9 reflection-docblock/src/DocBlock/Tags/Reference/Fqsen.phpnu Iw fqsen = $fqsen;
}
/**
* @return string string representation of the referenced fqsen
*/
public function __toString() : string
{
return (string) $this->fqsen;
}
}
PK ! . = reflection-docblock/src/DocBlock/Tags/Reference/Reference.phpnu Iw startingLine = (int) $startingLine;
$this->lineCount = $lineCount !== null ? (int) $lineCount : null;
$this->description = $description;
}
public static function create(
string $body,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::stringNotEmpty($body);
Assert::notNull($descriptionFactory);
$startingLine = 1;
$lineCount = null;
$description = null;
// Starting line / Number of lines / Description
if (preg_match('/^([1-9]\d*)\s*(?:((?1))\s+)?(.*)$/sux', $body, $matches)) {
$startingLine = (int) $matches[1];
if (isset($matches[2]) && $matches[2] !== '') {
$lineCount = (int) $matches[2];
}
$description = $matches[3];
}
return new static($startingLine, $lineCount, $descriptionFactory->create($description??'', $context));
}
/**
* Gets the starting line.
*
* @return int The starting line, relative to the structural element's
* location.
*/
public function getStartingLine() : int
{
return $this->startingLine;
}
/**
* Returns the number of lines.
*
* @return int|null The number of lines, relative to the starting line. NULL
* means "to the end".
*/
public function getLineCount() : ?int
{
return $this->lineCount;
}
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$startingLine = (string) $this->startingLine;
$lineCount = $this->lineCount !== null ? '' . $this->lineCount : '';
return $startingLine
. ($lineCount !== ''
? ($startingLine || $startingLine === '0' ? ' ' : '') . $lineCount
: '')
. ($description !== ''
? ($startingLine || $startingLine === '0' || $lineCount !== '' ? ' ' : '') . $description
: '');
}
}
PK ! 5 5 reflection-docblock/src/DocBlock/Tags/TagWithType.phpnu Iw type;
}
/**
* @return string[]
*/
protected static function extractTypeFromBody(string $body) : array
{
$type = '';
$nestingLevel = 0;
for ($i = 0, $iMax = strlen($body); $i < $iMax; $i++) {
$character = $body[$i];
if ($nestingLevel === 0 && trim($character) === '') {
break;
}
$type .= $character;
if (in_array($character, ['<', '(', '[', '{'])) {
$nestingLevel++;
continue;
}
if (in_array($character, ['>', ')', ']', '}'])) {
$nestingLevel--;
continue;
}
}
$description = trim(substr($body, strlen($type)));
return [$type, $description];
}
}
PK ! [Ϩ 1 reflection-docblock/src/DocBlock/Tags/Generic.phpnu Iw validateTagName($name);
$this->name = $name;
$this->description = $description;
}
/**
* Creates a new tag that represents any unknown tag type.
*
* @return static
*/
public static function create(
string $body,
string $name = '',
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::stringNotEmpty($name);
Assert::notNull($descriptionFactory);
$description = $body !== '' ? $descriptionFactory->create($body, $context) : null;
return new static($name, $description);
}
/**
* Returns the tag as a serialized string
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
return $description;
}
/**
* Validates if the tag name matches the expected format, otherwise throws an exception.
*/
private function validateTagName(string $name) : void
{
if (!preg_match('/^' . StandardTagFactory::REGEX_TAGNAME . '$/u', $name)) {
throw new InvalidArgumentException(
'The tag name "' . $name . '" is not wellformed. Tags may only consist of letters, underscores, '
. 'hyphens and backslashes.'
);
}
}
}
PK ! oVU 0 reflection-docblock/src/DocBlock/Tags/Throws.phpnu Iw name = 'throws';
$this->type = $type;
$this->description = $description;
}
public static function create(
string $body,
?TypeResolver $typeResolver = null,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::notNull($typeResolver);
Assert::notNull($descriptionFactory);
[$type, $description] = self::extractTypeFromBody($body);
$type = $typeResolver->resolve($type, $context);
$description = $descriptionFactory->create($description, $context);
return new static($type, $description);
}
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$type = (string) $this->type;
return $type . ($description !== '' ? ($type !== '' ? ' ' : '') . $description : '');
}
}
PK ! !N2
. reflection-docblock/src/DocBlock/Tags/Var_.phpnu Iw name = 'var';
$this->variableName = $variableName;
$this->type = $type;
$this->description = $description;
}
public static function create(
string $body,
?TypeResolver $typeResolver = null,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::stringNotEmpty($body);
Assert::notNull($typeResolver);
Assert::notNull($descriptionFactory);
[$firstPart, $body] = self::extractTypeFromBody($body);
$parts = Utils::pregSplit('/(\s+)/Su', $body, 2, PREG_SPLIT_DELIM_CAPTURE);
$type = null;
$variableName = '';
// if the first item that is encountered is not a variable; it is a type
if ($firstPart && $firstPart[0] !== '$') {
$type = $typeResolver->resolve($firstPart, $context);
} else {
// first part is not a type; we should prepend it to the parts array for further processing
array_unshift($parts, $firstPart);
}
// if the next item starts with a $ it must be the variable name
if (isset($parts[0]) && strpos($parts[0], '$') === 0) {
$variableName = array_shift($parts);
if ($type) {
array_shift($parts);
}
Assert::notNull($variableName);
$variableName = substr($variableName, 1);
}
$description = $descriptionFactory->create(implode('', $parts), $context);
return new static($variableName, $type, $description);
}
/**
* Returns the variable's name.
*/
public function getVariableName() : ?string
{
return $this->variableName;
}
/**
* Returns a string representation for this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
if ($this->variableName) {
$variableName = '$' . $this->variableName;
} else {
$variableName = '';
}
$type = (string) $this->type;
return $type
. ($variableName !== '' ? ($type !== '' ? ' ' : '') . $variableName : '')
. ($description !== '' ? ($type !== '' || $variableName !== '' ? ' ' : '') . $description : '');
}
}
PK ! #5 5 4 reflection-docblock/src/DocBlock/Tags/Deprecated.phpnu Iw version = $version;
$this->description = $description;
}
/**
* @return static
*/
public static function create(
?string $body,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
if (empty($body)) {
return new static();
}
$matches = [];
if (!preg_match('/^(' . self::REGEX_VECTOR . ')\s*(.+)?$/sux', $body, $matches)) {
return new static(
null,
$descriptionFactory !== null ? $descriptionFactory->create($body, $context) : null
);
}
Assert::notNull($descriptionFactory);
return new static(
$matches[1],
$descriptionFactory->create($matches[2] ?? '', $context)
);
}
/**
* Gets the version section of the tag.
*/
public function getVersion() : ?string
{
return $this->version;
}
/**
* Returns a string representation for this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$version = (string) $this->version;
return $version . ($description !== '' ? ($version !== '' ? ' ' : '') . $description : '');
}
}
PK ! es
s
/ reflection-docblock/src/DocBlock/Tags/Since.phpnu Iw version = $version;
$this->description = $description;
}
public static function create(
?string $body,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : ?self {
if (empty($body)) {
return new static();
}
$matches = [];
if (!preg_match('/^(' . self::REGEX_VECTOR . ')\s*(.+)?$/sux', $body, $matches)) {
return null;
}
Assert::notNull($descriptionFactory);
return new static(
$matches[1],
$descriptionFactory->create($matches[2] ?? '', $context)
);
}
/**
* Gets the version section of the tag.
*/
public function getVersion() : ?string
{
return $this->version;
}
/**
* Returns a string representation for this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$version = (string) $this->version;
return $version . ($description !== '' ? ($version !== '' ? ' ' : '') . $description : '');
}
}
PK ! OO)
7 reflection-docblock/src/DocBlock/Tags/PropertyWrite.phpnu Iw name = 'property-write';
$this->variableName = $variableName;
$this->type = $type;
$this->description = $description;
}
public static function create(
string $body,
?TypeResolver $typeResolver = null,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::stringNotEmpty($body);
Assert::notNull($typeResolver);
Assert::notNull($descriptionFactory);
[$firstPart, $body] = self::extractTypeFromBody($body);
$type = null;
$parts = Utils::pregSplit('/(\s+)/Su', $body, 2, PREG_SPLIT_DELIM_CAPTURE);
$variableName = '';
// if the first item that is encountered is not a variable; it is a type
if ($firstPart && $firstPart[0] !== '$') {
$type = $typeResolver->resolve($firstPart, $context);
} else {
// first part is not a type; we should prepend it to the parts array for further processing
array_unshift($parts, $firstPart);
}
// if the next item starts with a $ it must be the variable name
if (isset($parts[0]) && strpos($parts[0], '$') === 0) {
$variableName = array_shift($parts);
if ($type) {
array_shift($parts);
}
Assert::notNull($variableName);
$variableName = substr($variableName, 1);
}
$description = $descriptionFactory->create(implode('', $parts), $context);
return new static($variableName, $type, $description);
}
/**
* Returns the variable's name.
*/
public function getVariableName() : ?string
{
return $this->variableName;
}
/**
* Returns a string representation for this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
if ($this->variableName) {
$variableName = '$' . $this->variableName;
} else {
$variableName = '';
}
$type = (string) $this->type;
return $type
. ($variableName !== '' ? ($type !== '' ? ' ' : '') . $variableName : '')
. ($description !== '' ? ($type !== '' || $variableName !== '' ? ' ' : '') . $description : '');
}
}
PK ! e. H reflection-docblock/src/DocBlock/Tags/Formatter/PassthroughFormatter.phpnu Iw getName() . ' ' . $tag);
}
}
PK ! x폣 B reflection-docblock/src/DocBlock/Tags/Formatter/AlignFormatter.phpnu Iw maxLen = max($this->maxLen, strlen($tag->getName()));
}
}
/**
* Formats the given tag to return a simple plain text version.
*/
public function format(Tag $tag) : string
{
return '@' . $tag->getName() .
str_repeat(
' ',
$this->maxLen - strlen($tag->getName()) + 1
) .
$tag;
}
}
PK ! v=,+ 3 reflection-docblock/src/DocBlock/Tags/Formatter.phpnu Iw name = 'property-read';
$this->variableName = $variableName;
$this->type = $type;
$this->description = $description;
}
public static function create(
string $body,
?TypeResolver $typeResolver = null,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::stringNotEmpty($body);
Assert::notNull($typeResolver);
Assert::notNull($descriptionFactory);
[$firstPart, $body] = self::extractTypeFromBody($body);
$type = null;
$parts = Utils::pregSplit('/(\s+)/Su', $body, 2, PREG_SPLIT_DELIM_CAPTURE);
$variableName = '';
// if the first item that is encountered is not a variable; it is a type
if ($firstPart && $firstPart[0] !== '$') {
$type = $typeResolver->resolve($firstPart, $context);
} else {
// first part is not a type; we should prepend it to the parts array for further processing
array_unshift($parts, $firstPart);
}
// if the next item starts with a $ it must be the variable name
if (isset($parts[0]) && strpos($parts[0], '$') === 0) {
$variableName = array_shift($parts);
if ($type) {
array_shift($parts);
}
Assert::notNull($variableName);
$variableName = substr($variableName, 1);
}
$description = $descriptionFactory->create(implode('', $parts), $context);
return new static($variableName, $type, $description);
}
/**
* Returns the variable's name.
*/
public function getVariableName() : ?string
{
return $this->variableName;
}
/**
* Returns a string representation for this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
if ($this->variableName) {
$variableName = '$' . $this->variableName;
} else {
$variableName = '';
}
$type = (string) $this->type;
return $type
. ($variableName !== '' ? ($type !== '' ? ' ' : '') . $variableName : '')
. ($description !== '' ? ($type !== '' || $variableName !== '' ? ' ' : '') . $description : '');
}
}
PK ! )T
T
. reflection-docblock/src/DocBlock/Tags/Uses.phpnu Iw refers = $refers;
$this->description = $description;
}
public static function create(
string $body,
?FqsenResolver $resolver = null,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::notNull($resolver);
Assert::notNull($descriptionFactory);
$parts = Utils::pregSplit('/\s+/Su', $body, 2);
return new static(
self::resolveFqsen($parts[0], $resolver, $context),
$descriptionFactory->create($parts[1] ?? '', $context)
);
}
private static function resolveFqsen(string $parts, ?FqsenResolver $fqsenResolver, ?TypeContext $context) : Fqsen
{
Assert::notNull($fqsenResolver);
$fqsenParts = explode('::', $parts);
$resolved = $fqsenResolver->resolve($fqsenParts[0], $context);
if (!array_key_exists(1, $fqsenParts)) {
return $resolved;
}
return new Fqsen($resolved . '::' . $fqsenParts[1]);
}
/**
* Returns the structural element this tag refers to.
*/
public function getReference() : Fqsen
{
return $this->refers;
}
/**
* Returns a string representation of this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$refers = (string) $this->refers;
return $refers . ($description !== '' ? ($refers !== '' ? ' ' : '') . $description : '');
}
}
PK !
1 reflection-docblock/src/DocBlock/Tags/Example.phpnu Iw filePath = $filePath;
$this->startingLine = $startingLine;
$this->lineCount = $lineCount;
if ($content !== null) {
$this->content = trim($content);
}
$this->isURI = $isURI;
}
public function getContent() : string
{
if ($this->content === null || $this->content === '') {
$filePath = $this->filePath;
if ($this->isURI) {
$filePath = $this->isUriRelative($this->filePath)
? str_replace('%2F', '/', rawurlencode($this->filePath))
: $this->filePath;
}
return trim($filePath);
}
return $this->content;
}
public function getDescription() : ?string
{
return $this->content;
}
public static function create(string $body) : ?Tag
{
// File component: File path in quotes or File URI / Source information
if (!preg_match('/^\s*(?:(\"[^\"]+\")|(\S+))(?:\s+(.*))?$/sux', $body, $matches)) {
return null;
}
$filePath = null;
$fileUri = null;
if ($matches[1] !== '') {
$filePath = $matches[1];
} else {
$fileUri = $matches[2];
}
$startingLine = 1;
$lineCount = 0;
$description = null;
if (array_key_exists(3, $matches)) {
$description = $matches[3];
// Starting line / Number of lines / Description
if (preg_match('/^([1-9]\d*)(?:\s+((?1))\s*)?(.*)$/sux', $matches[3], $contentMatches)) {
$startingLine = (int) $contentMatches[1];
if (isset($contentMatches[2])) {
$lineCount = (int) $contentMatches[2];
}
if (array_key_exists(3, $contentMatches)) {
$description = $contentMatches[3];
}
}
}
return new static(
$filePath ?? ($fileUri ?? ''),
$fileUri !== null,
$startingLine,
$lineCount,
$description
);
}
/**
* Returns the file path.
*
* @return string Path to a file to use as an example.
* May also be an absolute URI.
*/
public function getFilePath() : string
{
return trim($this->filePath, '"');
}
/**
* Returns a string representation for this tag.
*/
public function __toString() : string
{
$filePath = (string) $this->filePath;
$isDefaultLine = $this->startingLine === 1 && $this->lineCount === 0;
$startingLine = !$isDefaultLine ? (string) $this->startingLine : '';
$lineCount = !$isDefaultLine ? (string) $this->lineCount : '';
$content = (string) $this->content;
return $filePath
. ($startingLine !== ''
? ($filePath !== '' ? ' ' : '') . $startingLine
: '')
. ($lineCount !== ''
? ($filePath !== '' || $startingLine !== '' ? ' ' : '') . $lineCount
: '')
. ($content !== ''
? ($filePath !== '' || $startingLine !== '' || $lineCount !== '' ? ' ' : '') . $content
: '');
}
/**
* Returns true if the provided URI is relative or contains a complete scheme (and thus is absolute).
*/
private function isUriRelative(string $uri) : bool
{
return strpos($uri, ':') === false;
}
public function getStartingLine() : int
{
return $this->startingLine;
}
public function getLineCount() : int
{
return $this->lineCount;
}
public function getName() : string
{
return 'example';
}
public function render(?Formatter $formatter = null) : string
{
if ($formatter === null) {
$formatter = new Formatter\PassthroughFormatter();
}
return $formatter->format($this);
}
}
PK ! Ħ / reflection-docblock/src/DocBlock/Tags/Param.phpnu Iw name = 'param';
$this->variableName = $variableName;
$this->type = $type;
$this->isVariadic = $isVariadic;
$this->description = $description;
$this->isReference = $isReference;
}
public static function create(
string $body,
?TypeResolver $typeResolver = null,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::stringNotEmpty($body);
Assert::notNull($typeResolver);
Assert::notNull($descriptionFactory);
[$firstPart, $body] = self::extractTypeFromBody($body);
$type = null;
$parts = Utils::pregSplit('/(\s+)/Su', $body, 2, PREG_SPLIT_DELIM_CAPTURE);
$variableName = '';
$isVariadic = false;
$isReference = false;
// if the first item that is encountered is not a variable; it is a type
if ($firstPart && !self::strStartsWithVariable($firstPart)) {
$type = $typeResolver->resolve($firstPart, $context);
} else {
// first part is not a type; we should prepend it to the parts array for further processing
array_unshift($parts, $firstPart);
}
// if the next item starts with a $ or ...$ or &$ or &...$ it must be the variable name
if (isset($parts[0]) && self::strStartsWithVariable($parts[0])) {
$variableName = array_shift($parts);
if ($type) {
array_shift($parts);
}
Assert::notNull($variableName);
if (strpos($variableName, '$') === 0) {
$variableName = substr($variableName, 1);
} elseif (strpos($variableName, '&$') === 0) {
$isReference = true;
$variableName = substr($variableName, 2);
} elseif (strpos($variableName, '...$') === 0) {
$isVariadic = true;
$variableName = substr($variableName, 4);
} elseif (strpos($variableName, '&...$') === 0) {
$isVariadic = true;
$isReference = true;
$variableName = substr($variableName, 5);
}
}
$description = $descriptionFactory->create(implode('', $parts), $context);
return new static($variableName, $type, $isVariadic, $description, $isReference);
}
/**
* Returns the variable's name.
*/
public function getVariableName() : ?string
{
return $this->variableName;
}
/**
* Returns whether this tag is variadic.
*/
public function isVariadic() : bool
{
return $this->isVariadic;
}
/**
* Returns whether this tag is passed by reference.
*/
public function isReference() : bool
{
return $this->isReference;
}
/**
* Returns a string representation for this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$variableName = '';
if ($this->variableName) {
$variableName .= ($this->isReference ? '&' : '') . ($this->isVariadic ? '...' : '');
$variableName .= '$' . $this->variableName;
}
$type = (string) $this->type;
return $type
. ($variableName !== '' ? ($type !== '' ? ' ' : '') . $variableName : '')
. ($description !== '' ? ($type !== '' || $variableName !== '' ? ' ' : '') . $description : '');
}
private static function strStartsWithVariable(string $str) : bool
{
return strpos($str, '$') === 0
||
strpos($str, '...$') === 0
||
strpos($str, '&$') === 0
||
strpos($str, '&...$') === 0;
}
}
PK ! mq 0 reflection-docblock/src/DocBlock/Tags/Author.phpnu Iw authorName = $authorName;
$this->authorEmail = $authorEmail;
}
/**
* Gets the author's name.
*
* @return string The author's name.
*/
public function getAuthorName() : string
{
return $this->authorName;
}
/**
* Returns the author's email.
*
* @return string The author's email.
*/
public function getEmail() : string
{
return $this->authorEmail;
}
/**
* Returns this tag in string form.
*/
public function __toString() : string
{
if ($this->authorEmail) {
$authorEmail = '<' . $this->authorEmail . '>';
} else {
$authorEmail = '';
}
$authorName = (string) $this->authorName;
return $authorName . ($authorEmail !== '' ? ($authorName !== '' ? ' ' : '') . $authorEmail : '');
}
/**
* Attempts to create a new Author object based on †he tag body.
*/
public static function create(string $body) : ?self
{
$splitTagContent = preg_match('/^([^\<]*)(?:\<([^\>]*)\>)?$/u', $body, $matches);
if (!$splitTagContent) {
return null;
}
$authorName = trim($matches[1]);
$email = isset($matches[2]) ? trim($matches[2]) : '';
return new static($authorName, $email);
}
}
PK ! P, > reflection-docblock/src/DocBlock/Tags/Factory/StaticMethod.phpnu Iw refers = $refers;
$this->description = $description;
}
public static function create(
string $body,
?DescriptionFactory $descriptionFactory = null,
?FqsenResolver $resolver = null,
?TypeContext $context = null
) : self {
Assert::stringNotEmpty($body);
Assert::notNull($descriptionFactory);
Assert::notNull($resolver);
$parts = Utils::pregSplit('/\s+/Su', $body, 2);
return new static(
self::resolveFqsen($parts[0], $resolver, $context),
$descriptionFactory->create($parts[1] ?? '', $context)
);
}
private static function resolveFqsen(string $parts, ?FqsenResolver $fqsenResolver, ?TypeContext $context) : Fqsen
{
Assert::notNull($fqsenResolver);
$fqsenParts = explode('::', $parts);
$resolved = $fqsenResolver->resolve($fqsenParts[0], $context);
if (!array_key_exists(1, $fqsenParts)) {
return $resolved;
}
return new Fqsen($resolved . '::' . $fqsenParts[1]);
}
/**
* Returns the structural element this tag refers to.
*/
public function getReference() : Fqsen
{
return $this->refers;
}
/**
* Returns a string representation of this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$refers = (string) $this->refers;
return $refers . ($description !== '' ? ($refers !== '' ? ' ' : '') . $description : '');
}
}
PK ! GP - reflection-docblock/src/DocBlock/Tags/See.phpnu Iw refers = $refers;
$this->description = $description;
}
public static function create(
string $body,
?FqsenResolver $typeResolver = null,
?DescriptionFactory $descriptionFactory = null,
?TypeContext $context = null
) : self {
Assert::notNull($descriptionFactory);
$parts = Utils::pregSplit('/\s+/Su', $body, 2);
$description = isset($parts[1]) ? $descriptionFactory->create($parts[1], $context) : null;
// https://tools.ietf.org/html/rfc2396#section-3
if (preg_match('/\w:\/\/\w/i', $parts[0])) {
return new static(new Url($parts[0]), $description);
}
return new static(new FqsenRef(self::resolveFqsen($parts[0], $typeResolver, $context)), $description);
}
private static function resolveFqsen(string $parts, ?FqsenResolver $fqsenResolver, ?TypeContext $context) : Fqsen
{
Assert::notNull($fqsenResolver);
$fqsenParts = explode('::', $parts);
$resolved = $fqsenResolver->resolve($fqsenParts[0], $context);
if (!array_key_exists(1, $fqsenParts)) {
return $resolved;
}
return new Fqsen($resolved . '::' . $fqsenParts[1]);
}
/**
* Returns the ref of this tag.
*/
public function getReference() : Reference
{
return $this->refers;
}
/**
* Returns a string representation of this tag.
*/
public function __toString() : string
{
if ($this->description) {
$description = $this->description->render();
} else {
$description = '';
}
$refers = (string) $this->refers;
return $refers . ($description !== '' ? ($refers !== '' ? ' ' : '') . $description : '');
}
}
PK ! O
0 reflection-docblock/src/DocBlock/Description.phpnu Iw create('This is a {@see Description}', $context);
*
* The description factory will interpret the given body and create a body template and list of tags from them, and pass
* that onto the constructor if this class.
*
* > The $context variable is a class of type {@see \phpDocumentor\Reflection\Types\Context} and contains the namespace
* > and the namespace aliases that apply to this DocBlock. These are used by the Factory to resolve and expand partial
* > type names and FQSENs.
*
* If you do not want to use the DescriptionFactory you can pass a body template and tag listing like this:
*
* $description = new Description(
* 'This is a %1$s',
* [ new See(new Fqsen('\phpDocumentor\Reflection\DocBlock\Description')) ]
* );
*
* It is generally recommended to use the Factory as that will also apply escaping rules, while the Description object
* is mainly responsible for rendering.
*
* @see DescriptionFactory to create a new Description.
* @see Description\Formatter for the formatting of the body and tags.
*/
class Description
{
/** @var string */
private $bodyTemplate;
/** @var Tag[] */
private $tags;
/**
* Initializes a Description with its body (template) and a listing of the tags used in the body template.
*
* @param Tag[] $tags
*/
public function __construct(string $bodyTemplate, array $tags = [])
{
$this->bodyTemplate = $bodyTemplate;
$this->tags = $tags;
}
/**
* Returns the body template.
*/
public function getBodyTemplate() : string
{
return $this->bodyTemplate;
}
/**
* Returns the tags for this DocBlock.
*
* @return Tag[]
*/
public function getTags() : array
{
return $this->tags;
}
/**
* Renders this description as a string where the provided formatter will format the tags in the expected string
* format.
*/
public function render(?Formatter $formatter = null) : string
{
if ($formatter === null) {
$formatter = new PassthroughFormatter();
}
$tags = [];
foreach ($this->tags as $tag) {
$tags[] = '{' . $formatter->format($tag) . '}';
}
return vsprintf($this->bodyTemplate, $tags);
}
/**
* Returns a plain string representation of this description.
*/
public function __toString() : string
{
return $this->render();
}
}
PK ! 1 ( reflection-docblock/src/DocBlock/Tag.phpnu Iw Important: each parameter in addition to the body variable for the `create` method must default to null, otherwise
* > it violates the constraint with the interface; it is recommended to use the {@see Assert::notNull()} method to
* > verify that a dependency is actually passed.
*
* This Factory also features a Service Locator component that is used to pass the right dependencies to the
* `create` method of a tag; each dependency should be registered as a service or as a parameter.
*
* When you want to use a Tag of your own with custom handling you need to call the `registerTagHandler` method, pass
* the name of the tag and a Fully Qualified Class Name pointing to a class that implements the Tag interface.
*/
final class StandardTagFactory implements TagFactory
{
/** PCRE regular expression matching a tag name. */
public const REGEX_TAGNAME = '[\w\-\_\\\\:]+';
/**
* @var array> An array with a tag as a key, and an
* FQCN to a class that handles it as an array value.
*/
private $tagHandlerMappings = [
'author' => Author::class,
'covers' => Covers::class,
'deprecated' => Deprecated::class,
// 'example' => '\phpDocumentor\Reflection\DocBlock\Tags\Example',
'link' => LinkTag::class,
'method' => Method::class,
'param' => Param::class,
'property-read' => PropertyRead::class,
'property' => Property::class,
'property-write' => PropertyWrite::class,
'return' => Return_::class,
'see' => SeeTag::class,
'since' => Since::class,
'source' => Source::class,
'throw' => Throws::class,
'throws' => Throws::class,
'uses' => Uses::class,
'var' => Var_::class,
'version' => Version::class,
];
/**
* @var array> An array with a anotation s a key, and an
* FQCN to a class that handles it as an array value.
*/
private $annotationMappings = [];
/**
* @var ReflectionParameter[][] a lazy-loading cache containing parameters
* for each tagHandler that has been used.
*/
private $tagHandlerParameterCache = [];
/** @var FqsenResolver */
private $fqsenResolver;
/**
* @var mixed[] an array representing a simple Service Locator where we can store parameters and
* services that can be inserted into the Factory Methods of Tag Handlers.
*/
private $serviceLocator = [];
/**
* Initialize this tag factory with the means to resolve an FQSEN and optionally a list of tag handlers.
*
* If no tag handlers are provided than the default list in the {@see self::$tagHandlerMappings} property
* is used.
*
* @see self::registerTagHandler() to add a new tag handler to the existing default list.
*
* @param array> $tagHandlers
*/
public function __construct(FqsenResolver $fqsenResolver, ?array $tagHandlers = null)
{
$this->fqsenResolver = $fqsenResolver;
if ($tagHandlers !== null) {
$this->tagHandlerMappings = $tagHandlers;
}
$this->addService($fqsenResolver, FqsenResolver::class);
}
public function create(string $tagLine, ?TypeContext $context = null) : Tag
{
if (!$context) {
$context = new TypeContext('');
}
[$tagName, $tagBody] = $this->extractTagParts($tagLine);
return $this->createTag(trim($tagBody), $tagName, $context);
}
/**
* @param mixed $value
*/
public function addParameter(string $name, $value) : void
{
$this->serviceLocator[$name] = $value;
}
public function addService(object $service, ?string $alias = null) : void
{
$this->serviceLocator[$alias ?: get_class($service)] = $service;
}
public function registerTagHandler(string $tagName, string $handler) : void
{
Assert::stringNotEmpty($tagName);
Assert::classExists($handler);
Assert::implementsInterface($handler, Tag::class);
if (strpos($tagName, '\\') && $tagName[0] !== '\\') {
throw new InvalidArgumentException(
'A namespaced tag must have a leading backslash as it must be fully qualified'
);
}
$this->tagHandlerMappings[$tagName] = $handler;
}
/**
* Extracts all components for a tag.
*
* @return string[]
*/
private function extractTagParts(string $tagLine) : array
{
$matches = [];
if (!preg_match('/^@(' . self::REGEX_TAGNAME . ')((?:[\s\(\{])\s*([^\s].*)|$)/us', $tagLine, $matches)) {
throw new InvalidArgumentException(
'The tag "' . $tagLine . '" does not seem to be wellformed, please check it for errors'
);
}
if (count($matches) < 3) {
$matches[] = '';
}
return array_slice($matches, 1);
}
/**
* Creates a new tag object with the given name and body or returns null if the tag name was recognized but the
* body was invalid.
*/
private function createTag(string $body, string $name, TypeContext $context) : Tag
{
$handlerClassName = $this->findHandlerClassName($name, $context);
$arguments = $this->getArgumentsForParametersFromWiring(
$this->fetchParametersForHandlerFactoryMethod($handlerClassName),
$this->getServiceLocatorWithDynamicParameters($context, $name, $body)
);
try {
$callable = [$handlerClassName, 'create'];
Assert::isCallable($callable);
/** @phpstan-var callable(string): ?Tag $callable */
$tag = call_user_func_array($callable, $arguments);
return $tag ?? InvalidTag::create($body, $name);
} catch (InvalidArgumentException $e) {
return InvalidTag::create($body, $name)->withError($e);
}
}
/**
* Determines the Fully Qualified Class Name of the Factory or Tag (containing a Factory Method `create`).
*
* @return class-string
*/
private function findHandlerClassName(string $tagName, TypeContext $context) : string
{
$handlerClassName = Generic::class;
if (isset($this->tagHandlerMappings[$tagName])) {
$handlerClassName = $this->tagHandlerMappings[$tagName];
} elseif ($this->isAnnotation($tagName)) {
// TODO: Annotation support is planned for a later stage and as such is disabled for now
$tagName = (string) $this->fqsenResolver->resolve($tagName, $context);
if (isset($this->annotationMappings[$tagName])) {
$handlerClassName = $this->annotationMappings[$tagName];
}
}
return $handlerClassName;
}
/**
* Retrieves the arguments that need to be passed to the Factory Method with the given Parameters.
*
* @param ReflectionParameter[] $parameters
* @param mixed[] $locator
*
* @return mixed[] A series of values that can be passed to the Factory Method of the tag whose parameters
* is provided with this method.
*/
private function getArgumentsForParametersFromWiring(array $parameters, array $locator) : array
{
$arguments = [];
foreach ($parameters as $parameter) {
$type = $parameter->getType();
$typeHint = null;
if ($type instanceof ReflectionNamedType) {
$typeHint = $type->getName();
if ($typeHint === 'self') {
$declaringClass = $parameter->getDeclaringClass();
if ($declaringClass !== null) {
$typeHint = $declaringClass->getName();
}
}
}
if (isset($locator[$typeHint])) {
$arguments[] = $locator[$typeHint];
continue;
}
$parameterName = $parameter->getName();
if (isset($locator[$parameterName])) {
$arguments[] = $locator[$parameterName];
continue;
}
$arguments[] = null;
}
return $arguments;
}
/**
* Retrieves a series of ReflectionParameter objects for the static 'create' method of the given
* tag handler class name.
*
* @param class-string $handlerClassName
*
* @return ReflectionParameter[]
*/
private function fetchParametersForHandlerFactoryMethod(string $handlerClassName) : array
{
if (!isset($this->tagHandlerParameterCache[$handlerClassName])) {
$methodReflection = new ReflectionMethod($handlerClassName, 'create');
$this->tagHandlerParameterCache[$handlerClassName] = $methodReflection->getParameters();
}
return $this->tagHandlerParameterCache[$handlerClassName];
}
/**
* Returns a copy of this class' Service Locator with added dynamic parameters,
* such as the tag's name, body and Context.
*
* @param TypeContext $context The Context (namespace and aliasses) that may be
* passed and is used to resolve FQSENs.
* @param string $tagName The name of the tag that may be
* passed onto the factory method of the Tag class.
* @param string $tagBody The body of the tag that may be
* passed onto the factory method of the Tag class.
*
* @return mixed[]
*/
private function getServiceLocatorWithDynamicParameters(
TypeContext $context,
string $tagName,
string $tagBody
) : array {
return array_merge(
$this->serviceLocator,
[
'name' => $tagName,
'body' => $tagBody,
TypeContext::class => $context,
]
);
}
/**
* Returns whether the given tag belongs to an annotation.
*
* @todo this method should be populated once we implement Annotation notation support.
*/
private function isAnnotation(string $tagContent) : bool
{
// 1. Contains a namespace separator
// 2. Contains parenthesis
// 3. Is present in a list of known annotations (make the algorithm smart by first checking is the last part
// of the annotation class name matches the found tag name
return false;
}
}
PK ! :. . 7 reflection-docblock/src/DocBlock/DescriptionFactory.phpnu Iw tagFactory = $tagFactory;
}
/**
* Returns the parsed text of this description.
*/
public function create(string $contents, ?TypeContext $context = null) : Description
{
$tokens = $this->lex($contents);
$count = count($tokens);
$tagCount = 0;
$tags = [];
for ($i = 1; $i < $count; $i += 2) {
$tags[] = $this->tagFactory->create($tokens[$i], $context);
$tokens[$i] = '%' . ++$tagCount . '$s';
}
//In order to allow "literal" inline tags, the otherwise invalid
//sequence "{@}" is changed to "@", and "{}" is changed to "}".
//"%" is escaped to "%%" because of vsprintf.
//See unit tests for examples.
for ($i = 0; $i < $count; $i += 2) {
$tokens[$i] = str_replace(['{@}', '{}', '%'], ['@', '}', '%%'], $tokens[$i]);
}
return new Description(implode('', $tokens), $tags);
}
/**
* Strips the contents from superfluous whitespace and splits the description into a series of tokens.
*
* @return string[] A series of tokens of which the description text is composed.
*/
private function lex(string $contents) : array
{
$contents = $this->removeSuperfluousStartingWhitespace($contents);
// performance optimalization; if there is no inline tag, don't bother splitting it up.
if (strpos($contents, '{@') === false) {
return [$contents];
}
return Utils::pregSplit(
'/\{
# "{@}" is not a valid inline tag. This ensures that we do not treat it as one, but treat it literally.
(?!@\})
# We want to capture the whole tag line, but without the inline tag delimiters.
(\@
# Match everything up to the next delimiter.
[^{}]*
# Nested inline tag content should not be captured, or it will appear in the result separately.
(?:
# Match nested inline tags.
(?:
# Because we did not catch the tag delimiters earlier, we must be explicit with them here.
# Notice that this also matches "{}", as a way to later introduce it as an escape sequence.
\{(?1)?\}
|
# Make sure we match hanging "{".
\{
)
# Match content after the nested inline tag.
[^{}]*
)* # If there are more inline tags, match them as well. We use "*" since there may not be any
# nested inline tags.
)
\}/Sux',
$contents,
0,
PREG_SPLIT_DELIM_CAPTURE
);
}
/**
* Removes the superfluous from a multi-line description.
*
* When a description has more than one line then it can happen that the second and subsequent lines have an
* additional indentation. This is commonly in use with tags like this:
*
* {@}since 1.1.0 This is an example
* description where we have an
* indentation in the second and
* subsequent lines.
*
* If we do not normalize the indentation then we have superfluous whitespace on the second and subsequent
* lines and this may cause rendering issues when, for example, using a Markdown converter.
*/
private function removeSuperfluousStartingWhitespace(string $contents) : string
{
$lines = explode("\n", $contents);
// if there is only one line then we don't have lines with superfluous whitespace and
// can use the contents as-is
if (count($lines) <= 1) {
return $contents;
}
// determine how many whitespace characters need to be stripped
$startingSpaceCount = 9999999;
for ($i = 1, $iMax = count($lines); $i < $iMax; ++$i) {
// lines with a no length do not count as they are not indented at all
if (trim($lines[$i]) === '') {
continue;
}
// determine the number of prefixing spaces by checking the difference in line length before and after
// an ltrim
$startingSpaceCount = min($startingSpaceCount, strlen($lines[$i]) - strlen(ltrim($lines[$i])));
}
// strip the number of spaces from each line
if ($startingSpaceCount > 0) {
for ($i = 1, $iMax = count($lines); $i < $iMax; ++$i) {
$lines[$i] = substr($lines[$i], $startingSpaceCount);
}
}
return implode("\n", $lines);
}
}
PK ! I4{ { / reflection-docblock/src/DocBlock/TagFactory.phpnu Iw $handler FQCN of handler.
*
* @throws InvalidArgumentException If the tag name is not a string.
* @throws InvalidArgumentException If the tag name is namespaced (contains backslashes) but
* does not start with a backslash.
* @throws InvalidArgumentException If the handler is not a string.
* @throws InvalidArgumentException If the handler is not an existing class.
* @throws InvalidArgumentException If the handler does not implement the {@see Tag} interface.
*/
public function registerTagHandler(string $tagName, string $handler) : void;
}
PK ! f f 2 reflection-docblock/src/DocBlock/ExampleFinder.phpnu Iw getFilePath();
$file = $this->getExampleFileContents($filename);
if (!$file) {
return sprintf('** File not found : %s **', $filename);
}
return implode('', array_slice($file, $example->getStartingLine() - 1, $example->getLineCount()));
}
/**
* Registers the project's root directory where an 'examples' folder can be expected.
*/
public function setSourceDirectory(string $directory = '') : void
{
$this->sourceDirectory = $directory;
}
/**
* Returns the project's root directory where an 'examples' folder can be expected.
*/
public function getSourceDirectory() : string
{
return $this->sourceDirectory;
}
/**
* Registers a series of directories that may contain examples.
*
* @param string[] $directories
*/
public function setExampleDirectories(array $directories) : void
{
$this->exampleDirectories = $directories;
}
/**
* Returns a series of directories that may contain examples.
*
* @return string[]
*/
public function getExampleDirectories() : array
{
return $this->exampleDirectories;
}
/**
* Attempts to find the requested example file and returns its contents or null if no file was found.
*
* This method will try several methods in search of the given example file, the first one it encounters is
* returned:
*
* 1. Iterates through all examples folders for the given filename
* 2. Checks the source folder for the given filename
* 3. Checks the 'examples' folder in the current working directory for examples
* 4. Checks the path relative to the current working directory for the given filename
*
* @return string[] all lines of the example file
*/
private function getExampleFileContents(string $filename) : ?array
{
$normalizedPath = null;
foreach ($this->exampleDirectories as $directory) {
$exampleFileFromConfig = $this->constructExamplePath($directory, $filename);
if (is_readable($exampleFileFromConfig)) {
$normalizedPath = $exampleFileFromConfig;
break;
}
}
if (!$normalizedPath) {
if (is_readable($this->getExamplePathFromSource($filename))) {
$normalizedPath = $this->getExamplePathFromSource($filename);
} elseif (is_readable($this->getExamplePathFromExampleDirectory($filename))) {
$normalizedPath = $this->getExamplePathFromExampleDirectory($filename);
} elseif (is_readable($filename)) {
$normalizedPath = $filename;
}
}
$lines = $normalizedPath && is_readable($normalizedPath) ? file($normalizedPath) : false;
return $lines !== false ? $lines : null;
}
/**
* Get example filepath based on the example directory inside your project.
*/
private function getExamplePathFromExampleDirectory(string $file) : string
{
return getcwd() . DIRECTORY_SEPARATOR . 'examples' . DIRECTORY_SEPARATOR . $file;
}
/**
* Returns a path to the example file in the given directory..
*/
private function constructExamplePath(string $directory, string $file) : string
{
return rtrim($directory, '\\/') . DIRECTORY_SEPARATOR . $file;
}
/**
* Get example filepath based on sourcecode.
*/
private function getExamplePathFromSource(string $file) : string
{
return sprintf(
'%s%s%s',
trim($this->getSourceDirectory(), '\\/'),
DIRECTORY_SEPARATOR,
trim($file, '"')
);
}
}
PK ! 6RS S / reflection-docblock/src/DocBlock/Serializer.phpnu Iw indent = $indent;
$this->indentString = $indentString;
$this->isFirstLineIndented = $indentFirstLine;
$this->lineLength = $lineLength;
$this->tagFormatter = $tagFormatter ?: new PassthroughFormatter();
}
/**
* Generate a DocBlock comment.
*
* @param DocBlock $docblock The DocBlock to serialize.
*
* @return string The serialized doc block.
*/
public function getDocComment(DocBlock $docblock) : string
{
$indent = str_repeat($this->indentString, $this->indent);
$firstIndent = $this->isFirstLineIndented ? $indent : '';
// 3 === strlen(' * ')
$wrapLength = $this->lineLength ? $this->lineLength - strlen($indent) - 3 : null;
$text = $this->removeTrailingSpaces(
$indent,
$this->addAsterisksForEachLine(
$indent,
$this->getSummaryAndDescriptionTextBlock($docblock, $wrapLength)
)
);
$comment = $firstIndent . "/**\n";
if ($text) {
$comment .= $indent . ' * ' . $text . "\n";
$comment .= $indent . " *\n";
}
$comment = $this->addTagBlock($docblock, $wrapLength, $indent, $comment);
return $comment . $indent . ' */';
}
private function removeTrailingSpaces(string $indent, string $text) : string
{
return str_replace(
sprintf("\n%s * \n", $indent),
sprintf("\n%s *\n", $indent),
$text
);
}
private function addAsterisksForEachLine(string $indent, string $text) : string
{
return str_replace(
"\n",
sprintf("\n%s * ", $indent),
$text
);
}
private function getSummaryAndDescriptionTextBlock(DocBlock $docblock, ?int $wrapLength) : string
{
$text = $docblock->getSummary() . ((string) $docblock->getDescription() ? "\n\n" . $docblock->getDescription()
: '');
if ($wrapLength !== null) {
$text = wordwrap($text, $wrapLength);
return $text;
}
return $text;
}
private function addTagBlock(DocBlock $docblock, ?int $wrapLength, string $indent, string $comment) : string
{
foreach ($docblock->getTags() as $tag) {
$tagText = $this->tagFormatter->format($tag);
if ($wrapLength !== null) {
$tagText = wordwrap($tagText, $wrapLength);
}
$tagText = str_replace(
"\n",
sprintf("\n%s * ", $indent),
$tagText
);
$comment .= sprintf("%s * %s\n", $indent, $tagText);
}
return $comment;
}
}
PK ! `w w 4 reflection-docblock/src/DocBlockFactoryInterface.phpnu Iw > $additionalTags
*/
public static function createInstance(array $additionalTags = []) : DocBlockFactory;
/**
* @param string|object $docblock
*/
public function create($docblock, ?Types\Context $context = null, ?Location $location = null) : DocBlock;
}
PK ! הE% E% + reflection-docblock/src/DocBlockFactory.phpnu Iw descriptionFactory = $descriptionFactory;
$this->tagFactory = $tagFactory;
}
/**
* Factory method for easy instantiation.
*
* @param array> $additionalTags
*/
public static function createInstance(array $additionalTags = []) : self
{
$fqsenResolver = new FqsenResolver();
$tagFactory = new StandardTagFactory($fqsenResolver);
$descriptionFactory = new DescriptionFactory($tagFactory);
$tagFactory->addService($descriptionFactory);
$tagFactory->addService(new TypeResolver($fqsenResolver));
$docBlockFactory = new self($descriptionFactory, $tagFactory);
foreach ($additionalTags as $tagName => $tagHandler) {
$docBlockFactory->registerTagHandler($tagName, $tagHandler);
}
return $docBlockFactory;
}
/**
* @param object|string $docblock A string containing the DocBlock to parse or an object supporting the
* getDocComment method (such as a ReflectionClass object).
*/
public function create($docblock, ?Types\Context $context = null, ?Location $location = null) : DocBlock
{
if (is_object($docblock)) {
if (!method_exists($docblock, 'getDocComment')) {
$exceptionMessage = 'Invalid object passed; the given object must support the getDocComment method';
throw new InvalidArgumentException($exceptionMessage);
}
$docblock = $docblock->getDocComment();
Assert::string($docblock);
}
Assert::stringNotEmpty($docblock);
if ($context === null) {
$context = new Types\Context('');
}
$parts = $this->splitDocBlock($this->stripDocComment($docblock));
[$templateMarker, $summary, $description, $tags] = $parts;
return new DocBlock(
$summary,
$description ? $this->descriptionFactory->create($description, $context) : null,
$this->parseTagBlock($tags, $context),
$context,
$location,
$templateMarker === '#@+',
$templateMarker === '#@-'
);
}
/**
* @param class-string $handler
*/
public function registerTagHandler(string $tagName, string $handler) : void
{
$this->tagFactory->registerTagHandler($tagName, $handler);
}
/**
* Strips the asterisks from the DocBlock comment.
*
* @param string $comment String containing the comment text.
*/
private function stripDocComment(string $comment) : string
{
$comment = preg_replace('#[ \t]*(?:\/\*\*|\*\/|\*)?[ \t]?(.*)?#u', '$1', $comment);
Assert::string($comment);
$comment = trim($comment);
// reg ex above is not able to remove */ from a single line docblock
if (substr($comment, -2) === '*/') {
$comment = trim(substr($comment, 0, -2));
}
return str_replace(["\r\n", "\r"], "\n", $comment);
}
// phpcs:disable
/**
* Splits the DocBlock into a template marker, summary, description and block of tags.
*
* @param string $comment Comment to split into the sub-parts.
*
* @return string[] containing the template marker (if any), summary, description and a string containing the tags.
*
* @author Mike van Riel for extending the regex with template marker support.
*
* @author Richard van Velzen (@_richardJ) Special thanks to Richard for the regex responsible for the split.
*/
private function splitDocBlock(string $comment) : array
{
// phpcs:enable
// Performance improvement cheat: if the first character is an @ then only tags are in this DocBlock. This
// method does not split tags so we return this verbatim as the fourth result (tags). This saves us the
// performance impact of running a regular expression
if (strpos($comment, '@') === 0) {
return ['', '', '', $comment];
}
// clears all extra horizontal whitespace from the line endings to prevent parsing issues
$comment = preg_replace('/\h*$/Sum', '', $comment);
Assert::string($comment);
/*
* Splits the docblock into a template marker, summary, description and tags section.
*
* - The template marker is empty, #@+ or #@- if the DocBlock starts with either of those (a newline may
* occur after it and will be stripped).
* - The short description is started from the first character until a dot is encountered followed by a
* newline OR two consecutive newlines (horizontal whitespace is taken into account to consider spacing
* errors). This is optional.
* - The long description, any character until a new line is encountered followed by an @ and word
* characters (a tag). This is optional.
* - Tags; the remaining characters
*
* Big thanks to RichardJ for contributing this Regular Expression
*/
preg_match(
'/
\A
# 1. Extract the template marker
(?:(\#\@\+|\#\@\-)\n?)?
# 2. Extract the summary
(?:
(?! @\pL ) # The summary may not start with an @
(
[^\n.]+
(?:
(?! \. \n | \n{2} ) # End summary upon a dot followed by newline or two newlines
[\n.]* (?! [ \t]* @\pL ) # End summary when an @ is found as first character on a new line
[^\n.]+ # Include anything else
)*
\.?
)?
)
# 3. Extract the description
(?:
\s* # Some form of whitespace _must_ precede a description because a summary must be there
(?! @\pL ) # The description may not start with an @
(
[^\n]+
(?: \n+
(?! [ \t]* @\pL ) # End description when an @ is found as first character on a new line
[^\n]+ # Include anything else
)*
)
)?
# 4. Extract the tags (anything that follows)
(\s+ [\s\S]*)? # everything that follows
/ux',
$comment,
$matches
);
array_shift($matches);
while (count($matches) < 4) {
$matches[] = '';
}
return $matches;
}
/**
* Creates the tag objects.
*
* @param string $tags Tag block to parse.
* @param Types\Context $context Context of the parsed Tag
*
* @return DocBlock\Tag[]
*/
private function parseTagBlock(string $tags, Types\Context $context) : array
{
$tags = $this->filterTagBlock($tags);
if ($tags === null) {
return [];
}
$result = [];
$lines = $this->splitTagBlockIntoTagLines($tags);
foreach ($lines as $key => $tagLine) {
$result[$key] = $this->tagFactory->create(trim($tagLine), $context);
}
return $result;
}
/**
* @return string[]
*/
private function splitTagBlockIntoTagLines(string $tags) : array
{
$result = [];
foreach (explode("\n", $tags) as $tagLine) {
if ($tagLine !== '' && strpos($tagLine, '@') === 0) {
$result[] = $tagLine;
} else {
$result[count($result) - 1] .= "\n" . $tagLine;
}
}
return $result;
}
private function filterTagBlock(string $tags) : ?string
{
$tags = trim($tags);
if (!$tags) {
return null;
}
if ($tags[0] !== '@') {
// @codeCoverageIgnoreStart
// Can't simulate this; this only happens if there is an error with the parsing of the DocBlock that
// we didn't foresee.
throw new LogicException('A tag block started with text instead of an at-sign(@): ' . $tags);
// @codeCoverageIgnoreEnd
}
return $tags;
}
}
PK ! ę : type-resolver/752161aedc0d6ed781ada8f3aa9db4973e187d1f.zipnu Iw PK ! : a type-resolver/2c8696b6cc4243b079e2f016d2da20c00c38c3e0.zipnu Iw PK ! $i= = > M reflection-common/6243ab17e2330fb7ce63d34391d53104cc913dc0.zipnu Iw PK ! t s) s) > < reflection-common/989820d4d3bc32a26c6e3cc70dd511d1b2102399.zipnu Iw PK ! @ f reflection-docblock/4a69b083486dbc03314e937e5613b9afb9863ebf.zipnu Iw PK ! ] ] @ iT reflection-docblock/8dff474b657832a5f4f52148225055696fe8e20f.zipnu Iw PK ! ܵ\# # 6: type-resolver/README.mdnu Iw PK ! 8 8 &^ type-resolver/LICENSEnu Iw PK ! % b type-resolver/phpbench.jsonnu Iw PK ! qM c type-resolver/composer.jsonnu Iw PK ! ҟn n g type-resolver/src/PseudoType.phpnu Iw PK ! 9 : & h type-resolver/src/Types/Collection.phpnu Iw PK ! # o type-resolver/src/Types/Static_.phpnu Iw PK ! tV@- - &
t type-resolver/src/Types/Expression.phpnu Iw PK ! | | ( x type-resolver/src/Types/AbstractList.phpnu Iw PK ! $&m m % d type-resolver/src/Types/Callable_.phpnu Iw PK ! ?*j j ! & type-resolver/src/Types/Null_.phpnu Iw PK ! 6 " type-resolver/src/Types/Scalar.phpnu Iw PK !
# و type-resolver/src/Types/Parent_.phpnu Iw PK ! ] " type-resolver/src/Types/Array_.phpnu Iw PK ! `!
* ( type-resolver/src/Types/AggregatedType.phpnu Iw PK ! /@ # type-resolver/src/Types/Context.phpnu Iw PK ! "B1eG G $ type-resolver/src/Types/Nullable.phpnu Iw PK ! 9q q % type-resolver/src/Types/Resource_.phpnu Iw PK ! =K K U type-resolver/src/Types/This.phpnu Iw PK ! "PB: : % type-resolver/src/Types/Iterable_.phpnu Iw PK ! F ! type-resolver/src/Types/Void_.phpnu Iw PK ! 28) type-resolver/src/Type.phpnu Iw PK ! rTP7H 7H " type-resolver/src/TypeResolver.phpnu Iw PK ! G6x # qc type-resolver/src/FqsenResolver.phpnu Iw PK ! "WAs s ( l type-resolver/src/PseudoTypes/False_.phpnu Iw PK ! )xo o ' p type-resolver/src/PseudoTypes/True_.phpnu Iw PK ! F| Nt type-resolver/composer.locknu Iw PK !
һO O } reflection-common/README.mdnu Iw PK ! *2Ȑ9 9 L reflection-common/LICENSEnu Iw PK ! ļ Ά reflection-common/composer.jsonnu Iw PK ! (n` , ى reflection-common/.github/workflows/push.ymlnu Iw PK ! bί ( reflection-common/.github/dependabot.ymlnu Iw PK ! .o reflection-common/src/File.phpnu Iw PK ! kDk ! reflection-common/src/Element.phpnu Iw PK ! ^L reflection-common/src/Fqsen.phpnu Iw PK ! 2X X ( + reflection-common/src/ProjectFactory.phpnu Iw PK ! p " ۴ reflection-common/src/Location.phpnu Iw PK ! 079 ! reflection-common/src/Project.phpnu Iw PK ! .=x
reflection-docblock/README.mdnu Iw PK ! 8 8 ` reflection-docblock/LICENSEnu Iw PK ! LAw< < ! reflection-docblock/composer.jsonnu Iw PK ! /qH{ { $ p reflection-docblock/src/DocBlock.phpnu Iw PK ! g2 2 ! ? reflection-docblock/src/Utils.phpnu Iw PK ! 4ZU\ 3 reflection-docblock/src/Exception/PcreException.phpnu Iw PK ! N~8
1 reflection-docblock/src/DocBlock/Tags/Version.phpnu Iw PK ! e؋{ { 1 reflection-docblock/src/DocBlock/Tags/BaseTag.phpnu Iw PK ! 8 2 reflection-docblock/src/DocBlock/Tags/Property.phpnu Iw PK ! t . reflection-docblock/src/DocBlock/Tags/Link.phpnu Iw PK ! ."- - 1 reflection-docblock/src/DocBlock/Tags/Return_.phpnu Iw PK ! J\ \ 0 " reflection-docblock/src/DocBlock/Tags/Method.phpnu Iw PK ! ះ 4 OC reflection-docblock/src/DocBlock/Tags/InvalidTag.phpnu Iw PK ! 7 uS reflection-docblock/src/DocBlock/Tags/Reference/Url.phpnu Iw PK !
v 9 V reflection-docblock/src/DocBlock/Tags/Reference/Fqsen.phpnu Iw PK ! . = &Z reflection-docblock/src/DocBlock/Tags/Reference/Reference.phpnu Iw PK ! BK
0 `\ reflection-docblock/src/DocBlock/Tags/Source.phpnu Iw PK ! 5 5 fj reflection-docblock/src/DocBlock/Tags/TagWithType.phpnu Iw PK ! [Ϩ 1 tp reflection-docblock/src/DocBlock/Tags/Generic.phpnu Iw PK ! oVU 0 }z reflection-docblock/src/DocBlock/Tags/Throws.phpnu Iw PK ! !N2
. reflection-docblock/src/DocBlock/Tags/Var_.phpnu Iw PK ! #5 5 4 9 reflection-docblock/src/DocBlock/Tags/Deprecated.phpnu Iw PK ! es
s
/ қ reflection-docblock/src/DocBlock/Tags/Since.phpnu Iw PK ! OO)
7 reflection-docblock/src/DocBlock/Tags/PropertyWrite.phpnu Iw PK ! e. H reflection-docblock/src/DocBlock/Tags/Formatter/PassthroughFormatter.phpnu Iw PK ! x폣 B 3 reflection-docblock/src/DocBlock/Tags/Formatter/AlignFormatter.phpnu Iw PK ! v=,+ 3 H reflection-docblock/src/DocBlock/Tags/Formatter.phpnu Iw PK ! ? i 6 reflection-docblock/src/DocBlock/Tags/PropertyRead.phpnu Iw PK ! )T
T
. 0 reflection-docblock/src/DocBlock/Tags/Uses.phpnu Iw PK !
1 reflection-docblock/src/DocBlock/Tags/Example.phpnu Iw PK ! Ħ / P reflection-docblock/src/DocBlock/Tags/Param.phpnu Iw PK ! mq 0 d reflection-docblock/src/DocBlock/Tags/Author.phpnu Iw PK ! P, >
reflection-docblock/src/DocBlock/Tags/Factory/StaticMethod.phpnu Iw PK ! t@}
}
0 reflection-docblock/src/DocBlock/Tags/Covers.phpnu Iw PK ! GP - reflection-docblock/src/DocBlock/Tags/See.phpnu Iw PK ! O
0 5' reflection-docblock/src/DocBlock/Description.phpnu Iw PK ! 1 ( e5 reflection-docblock/src/DocBlock/Tag.phpnu Iw PK ! sS1 S1 7 Z8 reflection-docblock/src/DocBlock/StandardTagFactory.phpnu Iw PK ! :. . 7 j reflection-docblock/src/DocBlock/DescriptionFactory.phpnu Iw PK ! I4{ { / reflection-docblock/src/DocBlock/TagFactory.phpnu Iw PK ! f f 2 reflection-docblock/src/DocBlock/ExampleFinder.phpnu Iw PK ! 6RS S / K reflection-docblock/src/DocBlock/Serializer.phpnu Iw PK ! `w w 4 reflection-docblock/src/DocBlockFactoryInterface.phpnu Iw PK ! הE% E% + ػ reflection-docblock/src/DocBlockFactory.phpnu Iw PK c c ) x